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USE OF THIS MANUAL 


This manual is to be used in conjunction with the loOFORTH Manual and the 
loFORTH Dictionary included with your Photometrics 3000 system. This manual 
assumes that the reader has a basic knowledge of the FORTH operating 
system. Beginners to FORTH as well as beginners to the Photometrics 3000 
system should start with the lOFORTH Manual, and proceed to this manual. 


Leo Brodie's Starting FORTH (Prentice-Hall Publishers) is recommended as 
a good starting book on FORTH. 


MANUAL FORMAT 


In this manual, user entries, key names, and file names are in bold print 
(command). Command entries must be lowercased and terminated with a 
carriage return (<cr>), sometimes referred to as the ENTER key. When this 
manual instructs the user to enter command xX, it is implicitly asking for 
command x <cr>. 
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PART 1. 
OPERATIONS GUIDE 


~~ 


1.0 GETTING STARTED 


1.1 INTRODUCTION 


1.1.1. This tutorial conducts a brief tour of the standard FORTH system 
procedures for image acquisition, display, and storage. It is recommended that 
the user be familiar with the concepts of image caches and windowing, 
discussed in Sections 3.5 and 4.2, respectively, before undertaking this tutorial. 


1.1.2 User entries and computer responses are in bold print (command). 
Command entries must terminate with a carriage return. 


1.1.3. When a command is described in this tutorial, parameters appear 
between brackets. However, when that command is entered on the keyboard, 
no brackets are required. Thus, with parameters 1000 and 2060, the <gmin> 
<gmax> show command is entered as 1000 2060 show. 


1.2 STARTING UP THE SYSTEM 
1.2.1 Figure 1-1 presents an overview of system startup commands. 


1.2.2 Turn on the system. When the Winchester disk reaches full speed, a tone 
sounds. Press the RESET button on the front of the computer chassis. 


1.2.3 When the prompt (>) appears, bw invokes the computer disk bootstrap 
program. 


1.2.4 The next event depends upon the software that you elected to have 
shipped with your system. If the Winchester disk is configured to the UNIX™ 
boot kernel, either UNIX™ or FORTH can run on your system (Option 1). If the 
Winchester disk is configured to the FORTH boot kernel, FORTH runs on your 
system (Option 2). 


1.2.5 Option 1: Booting FORTH from the UNIX™ Boot Kernel 

1.2.5.1 The terminal screen should now display the message 
Standalone Boot 

followed by a colon (:) prompt two lines below. 


1.2.5.2 forth followed by two carriage returns results in the appearance of the 
lo, Inc. banner, followed by the backslash (\) FORTH operating system prompt. 
25 load starts the FORTH CCD camera control program. After a display of 
redefinition messages, a TTY message appears which asks you to confirm the 
terminal type in use. If the terminal listed is correct, enter a carriage return. If 
you wish to change the terminal type, refer to Table 1-1 for a listing of supported 
terminals and enter the corrected terminal code. 


Press RESET 
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Figure 1-1. How to access CCD commands for systems configured 
with the Standalone FORTH Boot Kernel, the UNIX™Boot Kernel with 
FORTH, or the UNIX™ Boot Kernel. 
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Table 1-1. Supported Terminals 


Terminal Cod Manufacturer Comments 
vt100 (generic) Non-graphics 
hri00 Selanar Emulates VT100 
tvi925 * TeleVideo Non-graphics 
mt301 MicroTerm Emulates VT100 
qvi220 Qume Emulates VT100 


* Adam3a emulates TVI925; use tvi925 terminal code for Adam3a terminal. 


1.2.6 Option 2: Booting FORTH from the Standalone FORTH Kernel 


The lo, Inc. banner appears, followed by the backslash (\) FORTH operating 
system prompt. 25 load starts the FORTH CCD camera control program. After 
a display of redefinition messages, a TTY message asks you to confirm the 
terminal type in use. If the terminal listed is correct, enter a carriage return. If 
you wish to change the terminal type, refer to table 1-1 for a listing of supported 
terminals and enter the corrected terminal code. 


1.3 RUNNING THE CCD PROGRAM 


1.3.1 The CCD program operates in either of two modes. In the first mode, 
selected by entering the command fancy, the program prompt is an asterisk (*). 
In the fancy mode, a status line is maintained at the top of the screen. In the 
second mode, selected by entering the command plain, the program prompt is 
a backslash (\). In the plain mode, no status line appears. The fancy mode has 
a somewhat slower terminal response time, but must be selected to enable the 
mouse. 


1.3.2 When the program prompt appears, the computer is ready to run the CCD 
camera and Photometrics 3000 FORTH image processing commands. 


1.4 ACQUIRING AND DISPLAYING AN IMAGE, AND REMOVING DC 
OFFSET FROM THAT IMAGE 


1.4.1. Point the camera at an object or scene. Because some CCDs are very 
light sensitive, do not expose a brightly lit subject. If a bright subject cannot be 
avoided, standard neutral density lens filters may help to prevent CCD 
saturation. Bright lights do not harm the CCD. 


1.4.2 bias clears charge from the CCD and specifies image cache 1 in 
preparation for the <n> <t> focus command. 


1.4.3 20 2 focus reads out twenty consecutive 100 x 100 pixel images from 
the region of the cross cursor into the center of the video display. Each image is 
exposed for two-tenths of a second. Manually adjust the aperture and focal 
length to correct the focus in real time. 


1.4.4 2 obs takes an exposure that is two-tenths of a second in length. This full 
size, focused image becomes the current image and is stored in image cache 1. 


1.4.5 Because image cache 1 is filled, image cache 2 is available for frame 
storage. Enter 2 ci to select image cache 2 as the current image cache. 


1.4.6 bias acquires a bias frame into image cache 2 by performing a 0-length 
exposure of the DC offset. 


1.4.7 1 ci selects image cache 1 as the current image cache once again. 
1.4.8 pz zeros the image plane in order to better view the graphics plane. 


1.4.9 The graphics plane can be invoked to determine optimal window display 
parameters. 200 pcol superimposes on the image plane a plot of the pixel 
values that comprise column 200 of the current image. The pixel numbers and 
pixel values are plotted on the x and y axes, respectively. Note that the 
orientation of the graphics plane is reversed relative to the image plane. 


1.4.10 2i- subtracts the bias frame stored in image cache 2 from the current 
image and leaves the results in the current image cache. 


1.4.11 oplot 200 pcol plots the pixel values in column 200 of the bias- 
subtracted image on the same set of axes as the uncorrected image. These two 
curves provide a visual representation of the results of bias subtraction from a 
current image. 


1.4.12 gz zeros the graphics plane. 


1.4.13 200 pcol plots the pixel values in column 200 of the bias-subtracted 
image on a separate set of axes. 


1.4.14 Determine the numeric value of the smallest (min) and largest (max) 
pixel values plotted on the y axis, excluding unusually high and low plot points. 
Using these values for gmin and gmax, enter <gmin> <gmax> show to 
window and display the bias-subtracted image. 


1.4.15 gz zeros the graphics plane to better view the displayed image. 


Ss: ee 


ores 


1.4.16 When you are done viewing the displayed image, pz clears the image 
plane once again. 


1.5 CHANGING THE APPEARANCE OF THE IMAGE PLANE 


1.5.1 If the CCD array in your camera head exceeds 640 x 480 pixels, the 
image plane must be compressed with the squeeze command in order to view 
the current image in its entirety. <gmin> <gmax> 2 squeeze compresses 
the image plane by a factor of 2. For gmin and gmax, enter the pixel values 
that you entered earlier for show. 


1.5.2 pz clears the image plane. 


1.5.3 <gmin> <gmax> 4 squeeze compresses the image plane by a factor 
of 4. For gmin and gmax, enter the pixel values that you entered earlier for 
<gmin> <gmax> 2 squeeze. 


1.5.4 11 2z0om restores the image plane to its original dimensions. 
1.5.5 5 1zoom expands the image along the vertical axis. 

1.5.6 38 zoom expands the image asymetrically along both axes. 
1.5.7 11 zoom restores the original image once again. 

1.6 INTERACTIVE CURSOR MODE 


1.6.1 The FORTH CCD program supports two commands that permit the user to 
interact directly with the image plane: sw (show window) and sb (show box). 
These two commands change the way that the keyboard is used. The CCD 
program interprets only nine keystrokes for each command; the rest are 
ignored. 


1.6.2 sw permits the user to window the image plane interactively. A white 
cross, the cross cursor, appears in the center of the video display. The h, j, k, 
and I keys move the cross cursor: h left, | right, j down and k up. The cross 
cursor moves one pixel per keystroke. If the keystrokes are entered as upper 
case letters, the cursor moves by ten pixel units. 


1.6.3 The keystrokes u, i, 0, and p cause a 32 x 32 pixel square to be 
changed in appearance. u and p affect the DC offset; i and o affect the 
contrast. u and p have opposite effects in that they change the minimum and 
maximum window parameters in tandem: u lowers them, p raises them. i ando 
increase and decrease the range of the minimum and maximum window 
parameters, respectively, while keeping the mean constant. Entering the 
keystrokes as upper case letters increases effects tenfold. 


1.6.4 A status line appears across the top of the screen. This line displays, from 


left to right, the current location of the cross cursor (row coordinate, column 


coordinate), the pixel value at that location, and the current minimum and 
maximum pixel values for windowing. Two of the first three numbers change 
with each h, j, k, or | keystroke to reflect the specifications of the pixel upon 
which the cross cursor is currently placed; the fourth and fifth numbers change 
at entry of u, i, 0, or p. 


1.6.5 Practice with the h, j, k, and 1, and u, i, 0, and p keys. When you are 
satisfied with the appearance of the image in the window, enter q to end the 
window activity and return the program to the program prompt. 


1.6.6 qshow displays the current image at the new pixel minimum and 
maximum set by the window cursor. 


1.6.7 sb permits the user to specify and read out CCD subarrays for rapid 
digitization of areas of interest. A 32 x 32 pixel box, the box cursor, is centered 
where the cross cursor last stood. The box cursor may be difficult to see if it is 
located on top of a very light image. 


1.6.8 In the sb routine, the keystrokes h, j,k, and | move the box as they 
moved the cross cursor, but the u, i, 0, and p keys take on new meanings. 
These keys now affect the shape of the box. If the box is made larger (by 0 or 
p), the time required to subsequently return the image statistics lengthens 
considerably. The box cursor cannot be made smaller than a 2 x 2 pixel array 
nor larger than a full array. The box cursor cannot be moved outside of the 
range of the image plane. 


1.7 ACQUIRING A SUBARRAY AS A NEW IMAGE 

1.7.1 The box cursor may be used to define a subarray of the CCD to be read 
from the camera. Change the size, shape, and location of the box cursor with 
the u, i, 0, p, and h, j, k, and I keys, positioning the box over an area that you 
wish to make into a subimage. Enter q to end the sb activity. 


1.7.2 setrec establishes the position and size of the box cursor to be the format 
of the next camera readout. 


1.7.3 clept clears the picture table. 


1.7.4 2 obs acquires into image cache 1 a subimage with the same 
dimensions as the box cursor . 


1.7.5 pz clears the image plane. 


1.7.6 sho displays the subimage in image cache 1 with the windowing values 
last entered for <gmin> <gmax> show. 


1.7.7. Sw engages the cross cursor. The h, j, k, and 1 keys move the cross 
cursor to another part of the screen. q exits the cross cursor routine. 


1.7.8 pz clears the image plane. 2 


1.7.9 pan displays the image plane with the new cross cursor location 
centered in the screen. 


1.7.10 recenter locates the center of the image plane at the center of the 
screen once again. 


1.7.11 qshow displays the recentered image plane. 
1.7.12 reset returns the image plane to startup conditions. 
1.8 USING THE MOUSE 


1.8.1 The mouse gives the user the power to rapidly position the cross and box 
cursors around any portion of the displayed image. All subimage definition and 
acquisition activites can be performed with the mouse. The RS170 video 
monitor responds instantly to mouse commands. 


1.8.2 The three mouse buttons are referred to as buttons 1, 2, and 3, from left to 
right, when the mouse cable is pointed away from you (Figure 1-2). Place your 
hand over the mouse, with your fingers pointing toward the mouse cable. With 
the current image displayed on the screen, press and immediately release, or 
click, button 3. The cross cursor appears in the center of the screen to signify 
that you are now in interactive cursor mode. If the cross cursor does not appear, 
press button 3 for just a moment longer before release. With the cross cursor 
displayed, click button 3 again. The box cursor appears on the screen, 
centered on the spot where the cross cursor had stood. Click button 3 a third 
time. The box cursor disappears; you have left interactive cursor mode. Click 
button 3 a fourth time. The cycle is started over and the cross cursor reappears. 


1.8.3 To change the position of the cross cursor, position your hand over the 
mouse as before. Roll the mouse about on a tabletop surface in the direction 
you wish the cross cursor to move. Do not stop movement with the cross cursor 
in one of the four corners of the screen. Click button 3 again to obtain the box 
cursor. To change the position of the box cursor, roll the mouse about on the 
tabletop as before. To change the size of the box cursor, press and hold button 

2 while moving the mouse. Press and hold button 1 to increase the speed of 
mouse operations by a factor of four. 


1.8.4 The interactive cursor mode status line appears across the top of the 
screen during mouse use. Note that with movement of the mouse the first three 
parameters change to reflect the Spaciicaiens of the pixel upon which the cross 
cursor is currently placed. 


1.8.5 The mouse is locked out during command execution. You can continue 
to move the mouse, but the screen is not updated until after the computer is 
through with the activity entered from the keyboard. 


Press button 1 to increase the speed 
of mouse operations by a factor of 4. 


Press and hold down button 2 to 
change the size of the box cursor. 


Click button 3 once to bring up the 
cross cursor. Click button 3a 
second time to bring up the box 
cursor. Click button 3 a third time 
to leave interactive cursor mode. 





Figure 1-2. Mouse with Labeled Buttons 


1.9 WRITING THE CURRENT IMAGE TO THE WINCHESTER DISK 


1.9.1 Three hardware devices serve as archives for the Photometrics 3000 
system. These are the Winchester disk, the 1/4-inch tape cartridge, and the 
optional nine track magnetic tape. 


1.9.2 As delivered, the Winchester disk contains representative images taken 
with your camera: a bias frame in file 11, a low light level image in file 12, anda 
high light level image in file 13. Is lists on the terminal screen all images that 
are Currently stored on the Winchester disk. At the left margin, image nn 
provides an alphanumeric name for file number nn. The text that follows 
provides the date, time, and file format from the time that file was created. A file 
comment written by a user can be found on the line below. If no file comment 
has been entered, the comment line is not displayed. 


1.9.3 comment permits the user to enter a file comment. At the prompt, enter a 
comment regarding the current image, ending with a carriage return. 


1.9.4. +write enables writing to the Winchester disk. . 


1.9.5 <n> dw writes the current image to the Winchester disk as file n. Choose 
a value for n that is not currently listed by the Is command. 


1.9.6 When the program prompt returns, Is lists your new entry, appended to 
the end of the list of images stored on the Winchester disk. 


1.10 READING AN IMAGE FROM THE WINCHESTER DISK 
1.10.1 Listing RAM Contents 


1.10.1.1. qci reports the number of the current image cache, and the number of 
columns and rows in that cache. 


1.10.1.2 qimages lists all existing image caches and their dimensions. The 
first column lists all existing image caches. The second and third columns list, 
respectively, the number of columns and number of rows in each image cache. 
1.10.2 Retrieving a Stored Image 


1.10.2.1 1 ci selects image cache 1 as the image cache into which the 
retrieved image is to be placed. 


1.10.2.2 11 dr retrieves image 11 from the Winchester disk, overwriting the 
image that is currently stored in image cache 1. 


1.10.2.3 The program prompt reappears after a few seconds. qshow displays 
the retrieved image. 


1.11 ENDING A SESSION 


Press the RESET button, switch off theCE200/IC200, then switch off the 
remaining hardware. 


2.0 THE CCD IMAGER - 


2.1 INTRODUCTION 


2.1.1 A charge-coupled device (CCD) imager is a MOS (metal-oxide- 
semiconductor) optical detector that is composed of up to several million 
independent sites where photon-induced charge is stored. These photosites 
are called picture elements, or pixels. When pixels that are closely arranged in 
a rectangle are exposed to light, a charge pattern accumulates that 
corresponds to an illumination pattern. CCD pixels may be square or 
rectangular and range from 6 to 30 pin size. Figure 2-1 is a typical 512 x 512 
pixel CCD with 20 p pixels. Although a 512 x 512 pixel array is illustrated, many 
CCD formats and aspect ratios are available; the choice of CCD is usually 
dictated by the application. 


2.1.2 When a CCD is struck by light, the resulting electronic charge is collected 
into a two-dimensional imaging area called the parallel register. The parallel 
register consists of a series of fixed, electron-conducting channels. Permanent 
barriers, or channel stops, limit the migration of charge from one channel to the 
next. Perpendicular to the channels are electrodes, or gates, which, when 
properly biased with electrical potentials, establish electron collecting regions, 
or potential wells, in the channels. Zones of higher electric potential 
surrounding each potential well serve as barriers to keep the photoelectrons in 
the potential wells (Figure 2-2). 


2.1.3. The CCD contains a second register, the serial register, which is itself a 
one-dimensional CCD and plays an important role during CCD readout. 


2.2 CHARGE TRANSFER CONCEPT AND CCD READOUT > 


2.2.1 When a CCD is exposed to light, charge accumulates in the potential 
wells of the parallel register. Charge can accumulate over an extended period 
of time; the total amount of accumulated charge is proportional to the product of 
the light intensity and the exposure time. Exposure length is normally controlled 
by an electronic shutter for exposures ranging from milliseconds to hours. 
When sufficient charge has accumulated in the potential wells to suit the 
application at hand, the CCD is ready to be read out. 


2.2.2 Figure 2-3 depicts the charge transfer concept upon which CCD readout 
is based. A programmed sequence of changing gate potentials propagates the 
potential wells across the CCD, thereby forcing the charge to transfer from pixel 
to eg in a serial fashion through the controlled movement of the potential 
wells. 


2.2.3 Figure 2-4 illustrates the CCD readout sequence. Changing gate 
potentials cause all charge packets stored in the parallel register to be shifted in 
parallel one row towards the serial register. The charge stored in the top pixel 
row is shifted from the parallel register into the serial register. Once in the serial 
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Figure 2-3. Charge Transfer in a 3-Phase CCD 


12 


jnopeay GOO v-2 anbly 


"INO pea aq 0} 
. apou yndjno ayy 49)S1Ba1 eas Apeas S1q99 eu 
pase) S| Jasi6e1 psemo} payiys ‘sasibas jayyesed au} u! 


Ou} O}U! payiys 
TeUy Lye 40)8/601 —= Ayenpiaipur ase — Ss! MOJ do} aU, = abeyo jo ulajyed & se 


jeuas ay) OjU! paylys ; . 
@q UGS mo! 1xAU BUY sjexid ‘saysiGes jajesed ut pays sayejnuinooe abe! 


jeuas ay) ul aoUD a2 SMO4 II aiuodjoaja uy *jY6I 0} 
pasodxa s! G99 eUL 


MM sajsiBay jayeseg 






<@— sajsiBay jeyes 





epoN Indjno 


13 


register, these charge packets are individually shifted toward the output 
amplifier. The output amplifier produces an amplified and measurable signal 
that is proportional to the quantity of the charge in each charge packet. 


2.2.4 After the serial register is emptied of charge, a second row of charge 
packets is shifted into that register from the parallel register for transport to the 
output amplifier. As charge is shifted out of the parallel register, empty pixel 
rows are left at the bottom of that register until it is completely emptied of charge. 
A new exposure can then be made and the process can be repeated. 


2.2.5 All CCDs depend on the efficient transport of charge from the photosite to 
an on-chip output amplifier. Because the charge from wells located far from the 
output amplifier must undergo many hundreds of transfers, the charge transfer 
efficiency (CTE) is of concern. A scientific-grade CCD exhibits a CTE of 
0.99997, where 1.0 is perfect. 


2.3 CCD ARCHITECTURE 


2.3.1 Three types of CCDs are used for electronic imaging (Figure 2-5). A full 
frame CCD has the most simple architecture. The classical CCD has a single 
parallel register used for photon collection, charge integration, and charge 
transport. Incident radiation must be blocked during the readout process in 
order to prevent "smearing" the image. An electronic shutter is typically used for 
this function. 


2.3.2 The parallel register of a frame transfer CCD is really composed of two 
CCDs in series, the image and storage arrays. The storage array is covered 
with an opaque mask so that light only strikes the image array. After the image 
array is exposed to light, the entire exposed electronic image is rapidly shifted 
to the storage array for readout. While the masked storage array is read out, the 
image array may acquire charge for the next image. A frame transfer CCD can 
operate continuously without a shutter at television frame rates. If the mask on 
the storage array is removed, the entire imager can be used as a full frame 
device. 


2.3.3 A third, less common integration and readout scheme uses a partially 
masked full frame CCD. All but a small portion of the CCD array is masked, a 
series of images is integrated on the subarray, then those images are shifted 
beneath the mask until the entire array is filled. The entire array is then read out 
as a single image which actually consists of a series of subarrays. 


2.4 THINNED CCDs 


2.4.1 Light normally enters the CCD through the parallel register gates. These 
gates are made of very thin polysilicon which is reasonably transparent to long 
wavelengths, but which becomes opaque at wavelengths shorter than 400 
nanometers. Thus, at short wavelengths, gate structure can interfere with 
incoming light. 
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2.4.2 It is possible to thin a CCD to approximately 10 p» and focus an image on 
the backside of the silicon where there is no gate structure. Thinned CCDs 
exhibit high sensitivity to light from the soft x-ray to the near-infrared regions of 
the spectrum. Figure 2-6 illustrates the two structures. 


Silicon 
Dioxide Silicon 


Gate Thinned 
Silicon 
——__> | <q 


Incoming _____ 
ight ———-— 





Figure 2-6. Thick (Left) and Thinned (Right) CCDs 
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3.0 IMAGE ACQUISITION 


3.1 EXPOSURES 


3.1.1. The camera system contains a hardware clock to time short duration 
exposures automatically. An exposure consists of rapid clearing of residual 
charge from the CCD, allowing a signal to accumulate, and reading out the 
CCD. There are three types of exposures: object, bias, and dark. 


3.1.2 A bias frame is acquired by the command bias. This command performs 
a 0-length exposure that clears the CCD of residual charge and immediately 
reads and digitizes the detector output to provide a measurement of the DC 
offset and any structure in the unexposed CCD signal. 


3.1.3. An image is acquired by the command <t>obs. The parameter t 
determines the length of the exposure in decisecond increments. The CCD is 
cleared of any accumulated charge, the shutter is opened, and the exposure is 
timed. When the specified time elapses, the shutter is closed and the image is 
read out. An image exposure is composed of the image plus the bias and any 
dark count that has accumulated over the exposure time. (Bias and dark count 
may be subtracted from acquired images.) For cryogenically-cooled CCDs, the 
dark accumulation rate is very small. The bias component is introduced 
electronically and is quite stable. The image read out from the CCD may 
contain modulation due to optical effects in the CCD or irregularities in the 
optical source. These effects generally can be compensated for by calibration 
against appropriate flat-field object exposures. 


3.1.4 A dark frame is acquired by the command <t> dark. This command 
clears the CCD of residual charge, allows charge to accumulate for t 
deciseconds from spontaneous generation with the shutter closed, then reads 
the accumulated charge. The dark exposure is usually made to be the same 
length as an image exposure or else is scaled in magnitude to represent the 
charge accumulated over an image exposure time. A dark frame contains the 
standard bias component as well as the dark signal. 


3.2 SUBARRAYS 


3.2.1 The Photometrics 3000 computer allows the digitized area on the CCD to 
be equal to or smaller than the intrinsic size of that CCD. When the entire CCD 
array is read out, the image or frame produced has the same dimensions as the 
CCD and is called a full image or full frame. When the CCD program is started, 
the default image area is set to the full CCD array. Subsections, or subarrays, 
may be specified and read out as subimages in order to digitize areas of 
interest with a resultant reduction in pixel count and increase in speed of image 
acquisition. 


3.2.2 Two methods can be used to alter the area read from the CCD. The 
ccdfmt command permits a subarray to be set up explicitly. Alternatively, the 
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graphics box can be invoked to establish the area to be read. The means of 
obtaining the graphics box are described in Section 4.0. After the box has been . 
sized and positioned over a portion of a full image, setrec computes the 
appropriate parameters to read that area from the detector at the next bias, 
image, or dark exposure. 


3.3 PIXEL LOCATION 


3.3.1 The CCD and all readout from the CCD are described as arrays where 
columns and rows have fixed maximum values that are determined by the size 
of the CCD. An image or frame is specified in terms of its numbers of columns 
and rows. The number of columns in the array is equal to the row length, and 
the number of rows is equal to the column length (Figure 3-1). 


3.3.2 The Photometrics 3000 computer specifies a pixel location by its column 
and row address. A 100 x 300 array implies an array that contains 100 columns 
and 300 rows. The first pixel has address col = 0, row = 0, otherwise referred to 
as (0,0). The 15th pixel has address col = 14, row = 0, or (14,0), and the 115th 
pixel in a 100 column array has address col = 14, row = 1, or (14,1). 


3.3.3 The origin of a full image or frame is at address (0,0). This pixel is the first 
pixel read out of the CCD. The location of a subimage is specified by its row or 
column offset, the distance of the subimage's origin in pixels from the origin of 
the surrounding full image. 


3.4 IMAGES AND IMAGE CACHES IN RAM 
3.4.1 Image Cache Concept 


3.4.1.1 RAM is dynamically allocated into image buffers, or image caches, that 
Store images or frames. Image caches are numbered in the order in which they 
are created. 


3.4.1.2 The current image cache is the image cache affected by user 
operations, such as image arithmetic, section plots, or image display. The 
image or frame stored in the current image cache is the current image. When 
an image or frame is acquired from the camera or host, it is acquired into the 
current image cache. This image cache remains the current image cache until 
the user uses the <n> ci command to select another image cache to be the 
current image cache. 


3.4.1.3 At startup, image cache 1 is the only image cache that is defined, or 
available for image or frame storage. Image cache 1 is the default current 
image cache and need not be selected with the <n> ci command. The act of 
image or frame acquisition specifies the dimensions of the current image cache 
to be those of the array placed into it. Commands that specify image caches 
are: bias, <t> dark, <n> dr, <n> extract, fbias, <t> fobs, <c> <r> fset, 
<t> obs, readout, sreadout, and <n> tr. 
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Figure 3-1. Full Array with Binned Subimage 
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3.4.2 Creation of Image Caches A 
3.4.2.1. When the computer starts up, RAM is empty because no images or 
frames have yet been acquired. An empty RAM is not yet subdivided into image 
caches. 


3.4.2.2 The process of acquiring an image into an empty cache automatically 
specifies the size of that cache and defines the origin for the next image cache, 
which becomes available at this point (figure 3-2). When the program starts, 
image cache 1 is the only image cache that is defined. To select image cache 2 
by the entry of 2 ci is illegal because the program does not know where image 
two starts -- image one has not been specified. Thus, image caches must be 
created in sequential order. Image cache 2 cannot be defined before image 
cache 1 is specified. 


3.4.2.3 Once an image is acquired into image cache 1, the origin of image 
cache 2 is defined and it becomes a legitimate cache to "enter" (it is still empty) 
for purposes of acquiring another image. Image cache 1 is now defined and 
specified. Specification of image cache 1 defines the origin of image cache 2. 
When 2 ci is entered, the next exposure taken reads the CCD out into image 
cache 2, the new current image cache. Image cache 2 is now defined and 
specified. 


3.4.2.4 Specification of image cache 2 defines image cache 3. When 3 ci is 
entered, an image or frame may be stored in image cache 3, the new current 
image cache. 


3.4.2.5 An image cache must be specified to be the same size as the image to 
be stored in that cache. If an attempt is made to read an image into an image 
cache of a different size, an error message results. ; 


3.4.2.6 Because the size of each array stored in RAM determines the size of 
each image cache as it is specified, the number of image caches that are 
available for image or frame storage varies with the sizes of the arrays stored. 
When RAN is full, no more images or frames may be stored, regardless of the 
number of specified image caches. 


3.4.3 Image Cache Operations 


3.4.3.1 clept (clear current picture table) revokes the specification of all image 
caches, leaving the current image cache to be image cache 1 (which is empty). 
The comments and other image identification parameters are removed. clcpt 
should be used with caution, because once RAM is cleared, previously stored 
images can only be recovered with difficulty. 


3.4.3.2 qimages lists the currently defined images, their size, and any 
comments that have been entered. If the output from qimages indicates an 
image that has 0 0 0 0 for the column origin, row origin, number of columns, and 
number of rows, the current image is specified but not defined. This situation 
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System startup. Image cache 1 is the current 


IMAGE CACHE 


1 image cache and is the only image cache 


that is defined, or available for image storage. 





IMAGE CACHE The <t> obs commandis issued to acquire an 
i image into image cache 1. This image becomes 
the current image. 


IMAGE CACHE The next image that is acquired may be placed 
2 into either image cache 1, overwriting the 
current image, or into image cache 2. 


2 ci selects image cache 2 to be the current 
image cache. The <t> obs command is issued 
to acquire a new current image. 


The next image acquired may be placed into 
image cache 1, 2, or3. 


IMAGE CACHE 
3 





Figure 3-2. Image Cache Concept 
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occurs after any clept or any time the current image is one larger than the last 
defined image. 


3.4.3.3 reset is a general software cleanup that clears the image and graphics 
planes, and sets the video display to startup conditions. reset does not change 
any image storage that has taken place. 


3.4.4 Image Headers 


3.4.4.1 Each image has an attendant header in which is stored the parameters 
of that image. Image header structure is given in Section 14 of Part 1. 


3.4.4.2 An image header provides size parameters for a previously unspecified 
image cache. Thus, an unspecified image cache may be filled with an image of 
any size. However, once an image cache is specified by the acquisition of an 
image from the camera or an archive, or by fset, all images that are 
subsequently read into that image cache must be the same size as the original 
image. 


3.4.4.3 If the size specification of the current image cache differs from that of an 
image being acquired from the camera or an archive, the program issues an 
error message and cancels the acquisition. 


3.4.4.4 The user may enter a comment into the ID portion of an image header 
only in RAM. It is necessary to explicitly rewrite the image to the archive to 
retain the comment. 


3.5 ADVANCED TOPICS: BINNING 


3.5.1 The user can combine the charge on adjacent pixels to form a subarray- 
prior to digitization. This binning can be undertaken in both rows and columns 
with the binning command (Figures 3-3 and 3-4). Successive rows can be 
combined to form a superrow. Successive pixels in the super row can be 
combined to achieve super pixels. The magnitude of the signal presented to the 
digitizer is the arithmetic sum of the summed pixels. Super pixels may have a 
higher signal-to-noise ratio than normal pixels, but at the cost of spatial 
resolution. It is necessary to adjust exposures to avoid saturation when binning. 


3.5.2 The binning is set to one by default. In the array specification, the number 
of pixels read out is counted after the binning has occurred. In order to avoid 
reading from beyond the edge of the detector, the sum of the origin plus the 
binning multiplied by the row or column pixel elements read must not exceed 
the physical dimensions of the CCD. 
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4.0 IMAGE DISPLAY 


4.1 IMAGE AND GRAPHICS PLANES 


4.1.1 The display memory has a 640 by 480 pixel format. It contains two planes: 
an image plane and a graphics plane. The image plane has a gray scale range 
of 0 to 255. The graphics plane is on/off. The two planes are merged electrically 
as the output video image is generated. This merged signal can be directed to 
any RS170 interlaced TV device. 


4.1.2 The graphics plane is presented as a white overlay on the image plane 
and is utilized for normal graphs. Because a graph can be difficult to see on top 
of a bright image, presentation of the image plane can be disabled by ioff and 
enabled by ion. The graphics overlay can be disabled by goff or enabled by 
gon. pz clears the image memory; gz erases the graphics plane. 


4.2 WINDOWING 


4.2.1 When a newly acquired image is digitized, the A/D converter assigns a 
value in A/D converter units (ADU) to each pixel. This ADU value, or pixe/ 
value, is proportional to the number of electrons stored in each pixel and can 
range from 0 to either 4,096 (12-bit CCD camera) or 16,383 (14-bit CCD 
camera). 


4.2.2 Because the RS170 video monitor has 8-bit precision, it can generate 
only 256 gray levels. Thus, to display an image with optimal contrast levels, the 
range of pixel values that comprise that image must be selected, then 
compressed or expanded to fill the RS170 video display. This scaling of pixel 
values, or windowing, is accomplished by setting the upper and lower window 
display parameters with the <gmin> <gmax> show command. In figure 4-1, 
the lower window display parameter (gmin) is -10500; the upper window 
display parameter (gmax) is 21000. 


4.2.3. gmin and gmax set the pixel values that are to be mapped into the 
minimum (zero) and maximum (255) intensity values of the video display. 
These minimum and maximum pixel values are referred to as min and max, 
respectively. The maxmin command reports the min and max pixel values in 
the current image cache. 


4.3 INTERACTIVE CURSOR MODE 

4.3.1 Introduction 

4.3.1.1 The user can select portions of the image plane for manipulation. Users 
can enter interactive cursor mode through use of the sw (set window) and sb 


(set box) commands. These commands require the entry of keystrokes for video 
display manipulation. The program also supports use of the mouse. 
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The 12 bit and 14 bit cameras provide 
raw data pixel values between 0 and 
4095, and 0 and 16383, respectively. 
Subsequent arithmetic calculations 
can produce values between -32768 
and +32767. 


In this example, the user has selected 
a lower window display parameter of 
-10500 and an upper window display 
parameter of 21000 for windowing. 
After selection, the system compresses 
these parameters to the range of the 
RS170 video monitor's 256-unit gray 
scale for display. 


The upper and lower window display 
parameters are used in display 
commands such as show, qshow, 
squeeze and sho. 





Figure 4-1. Windowing 
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4.3.1.2 The video display is in interactive cursor mode when one of two 
movable graphics cursors appears. The graphics cursors supported by the 
FORTH CCD program are the window cursor (cross cursor) and the box cursor. 
The array coordinates of the cross cursor are also the coordinates at the center 
of the box cursor. The box cursor can be positioned over any portion of a 
displayed image to define the outer bounds of a subimage which can then be 
manipulated. 


4.3.1.3 The cursor is located at the center of an image when the image is 
acquired or when the user selects a different array as the current image. 


4.3.2 Status Line 


4.3.2.1 Both graphics cursors display a status line across the top of the screen 
which displays the cross cursor's column, row, intensity, and minimum and 
maximum pixel values for windowing. A typical status line appears as follows: 


COL: 100 ROW: 80 INT: 3000 GMIN: 3138 GMAX: 5085 


4.3.2.2 The column, row, and intensity data change to reflect the specifications 
of the pixel upon which the cross cursor is placed at any given time. The last 
update remains on the screen (until it is erased) when the cursor routine is 
exited, although the cursor itself may be erased before exiting. 


4.3.3 Interactive Cursor Routines 


4.3.3.1 In the interactive cursor routines, certain keystrokes are interpreted as 
commands and all others keystrokes are ignored. 


4.3.3.2 The q (quit) key exits the interactive cursor routines. The keys h, j, k, 
and I cause the cursor to move left, down, up, and right, respectively. H, J, K, 
and L produce the same motion but in ten-pixel units rather than unit moves. 


4.3.3.3 The keystrokes are not buffered, so holding down a key does not stack 
up a large number of moves. Any keys other than those described are ignored. 
Though the use of keystrokes may appear complicated, only a short amount of 
time is required to become proficient at effective use of the interactive mode. 


4.3.4 The Interactive Window Cursor 


4.3.4.1 After an image is displayed, the sw command alters the appearance of 
a 64 x 64 pixel subarray that is centered at the current cross cursor position. 


4.3.4.2 The keys u,i, 0, and p change the appearance of the subarray. u 
subtracts 1% of the range of the current windowing from the current minimum 
and maximum. p adds 1% of the range to the current minimum and maximum. i 
subtracts 1% from the minimum and adds 1% to the maximum. o adds 1% to the 
minimum and subtracts 1% from the maximum. u and p move the DC value of 
the window down and up. i and o enlarge or diminish the range of the window 
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while keeping the mean the same. The same keystrokes executed as capital 
letters, U,1,O, and P, produce the same effect but with a 10% change in the 
current range per keystroke. The window cursor keystroke effects are 
summarized below: 


Exit from the interactive mode; 

Move the cursor one pixel position to the left; 

Move the cursor one pixel position down; 

Move the cursor one pixel position up; 

Move the cursor one pixel position to the right; 

Change the window by decreasing the gmin and gmax; 

Change the window by decreasing the gmin and increasing the gmax; 
Change the window by increasing the gmin and decreasing the gmax; 
Change the window by increasing the gmin and gmax. 


uwo™"oCo TK FTQA 


With a little practice, it is possible to use the interactive window cursor very 
effectively. 


4.3.5 The Interactive Box Cursor 


4.3.5.1 The box cursor is engaged by the command sb (show box). The 
location of the box cursor is that of the prior cursor. The u, i, 0, and p keystrokes 
cause the box to be enlarged or diminished horizontally and vertically. Again, 
lower case keys have unit effect; upper case keys have a 10-unit effect. The box 
is restrained to remain inside of the physical bounds of the image display. The 
center of any cursor is restrained to not exiting the current image. The boundary 
of the box may not extend onto the area of the display which does not contain 
any image. pcur lists the position of the cursor and the current box size. 


4.3.5.2 The box may be used to define an area to be read from the camera. 
Once the box is positioned upon a full image, setrec converts the image 
coordinates of the box into the appropriate detector readout parameters and 
sets up those parameters for the next image acquisition. 


4.4 MOUSE 
4.4.1. Introduction 


The mouse gives the user the power to point to selected pixels for manipulation 
or to specify a portion of the current image to be acquired as a subarray. For 
those users who wish to combine x-y coordinates with the use of the mouse, the 
top of the screen provides a constant update of the x, y, and z (intensity) 
coordinates of the cursor. 


4.4.2 Mouse Startup 
With an image displayed on the screen and the terminal fancy mode turned on, 


the mouse will automatically function when you press the right-most button on 
its top. For simple reference, the buttons on the top of the mouse are referred to 
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as buttons 1, 2, and 3, from left to right (Figure 4-2). To start the mouse, press 
and release button 3. If you press a button too briefly, the computer will not 
recognize the command. After you press button 3, the cross cursor (+) appears 
on the screen. When you press button 3 again, a box centered on the cursor is 
drawn on the screen. This is box mode. The default size of the box is 32 x 32 


pixels. 
4.4.3 Changing the Size of the Box 


Once in box mode, the size of the box can be changed by holding down button 
2 and moving the mouse on a tabletop surface. The location of the box can be 
changed by moving the mouse when button 2 is not being held down. 


4.4.4 Speed 


Whenever button 1 is held down, the speed of operations, such as cursor 
movement and box sizing, is increased by a factor of four. 


4.4.5 Mouse Lockout 


The mouse is locked out when acquiring or updating an image. You can 
continue to move the mouse, but the screen will not be updated until after the 
computer is through with what has been entered from the keyboard. 


4.4.6 Mouse Shutdown 


When the mouse is first activated, it is turned off. Neither a cross cursor nor a 
box appears on the screen. Clicking button 3 the first time turns on the mouse 
and causes the cross cursor to appear on the screen. Clicking button 3 a 
second time switches the cursor to box mode. Clicking button 3 a third time 
shuts down the mouse. Clicking it a fourth time starts the cycle over, bringing 
back the cross cursor. 


4.5 DISPLAY COMMANDS 


4.5.1 Display commands change the appearance of the image displayed on 
the RS170 video display. These commands affect only the displayed 
representation of the current image; the current image, stored in RAM, is not 
altered. 


4.5.2 Some display commands require user-defined min and max parameters, 
while other commands use system-defined parameters. In either case, 
windowing is performed automatically after these parameters are established. 


4.5.3 <gmin> <gmax> show requires that the user input windowing values 
prior to display of the current image. 
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Press button 1 to increase the speed 
of mouse operations by a factor of 4. 


Press and hold down button 2 to 
change the size of the box cursor. 


Click button 3 once to bring up the 
cross cursor. Click button3 a 
second time to bring up the box 
cursor. Click button 3 a third time 
to leave interactive cursor mode. 





Figure 4-2. Mouse with Labeled Buttons 
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4.5.4 sho displays the current image with previously established values for min 
and max. These pixel values could have been derived from a prior <gmin> 
<gmax> show command or from changes obtained with the cross cursor. 


4.5.5 qshow displays the current image with min and max obtained from a 32 x 
32 pixel area centered at the current cursor location. qshow automatically 
centers and displays the full image. 


4.5.6 <C> <r> zoom displays the current image centered at the cursor position 
as it writes each pixel as many times as is required to satisfy the user-specified 
column (¢) and row (r) parameters (figure 4-3). <c> <r> zoom uses current 
windowing parameters. When c andr are not the same, the displayed image 
appears to be elongated asymmetrically. 


4.5.7 11zZ00m (unit zoom) leaves the image offset at the current cursor 
position. recenter restores the image to normal centered positioning at unit 
zoom. 


4.5.8 <gmin> <gmax> <n> squeeze compresses the displayed image by a 
factor of 2 or 4 at the windowing specified by the user (figure 4-4). <gmin> 
<gmax> <n> squeeze is particularly useful for camera heads with large 
CCDs which read out images that are too large to be displayed’all at once. 


4.5.9 sq performs the same function as <gmin> <gmax> <n> squeeze, 
using previously established squeeze parameters. 


4.5.10 qsq compresses the displayed image by a factor of 2 or 4 with min and 
max obtained from a 32 x 32 pixel area centered at the current cursor location. 


4.5.11 pan centers the current image at the current cursor position. With pan, 
any portion of an oversized image may be moved to the center of the video 
display. 


4.5.12 Some CCDs invert the image plane horizontally. flip reverses the 
orientation of the image plane from left to right and must be followed by a 
display command, such as sho, for display (Figure 4-5). flip is particularly 
useful if the current image contains letters or words. 


4.5.13 nvideo inverts the output of the image plane (black pixels appear to be 
white and vice versa); pvideo restores the image plane to positive video. 
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Figure 4-3. zoom 


A. 


The user enters <gmin> <gmax> show to display a full size current image. 
The dark box defines the perimeter of the video display. 


The user enters 22 zoom. The displayed image no longer fits on the video display. 


The portion of the current image that is displayed in figure 4-3B. 
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Figure 4-4. squeeze 


The cross cursor is positioned at the center of the screen. The dark box defines the perimeter 


A. The user enters <gmin> <gmax> show to display an oversized current image on the video display. 
of the video display. 


The image plane is compressed by a factor of 2. 


B. The userenters <gmin> <gmax> 2 squeeze. 


The image plane is compressed by a factor of 4. 


C. Theuserenters <gmin> <gmax> 4 squeeze. 
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Figure 4-5. pan followed by flip 
A. 


The user enters <gmin> <gmax> show to display a full size current image, clicks 
mouse button 3 once to obtain the cross cursor, then moves the cursor to the 
Position shown. The dark box defines the perimeter of the video display. 


The user enters pan to center the current image at the cross cursor. The current 
image no longer fits on the video display. 


The portion of the current image that is displayed in figure 4-5B. 
The user enters flip sho, flips horizontally the orientation of the video display, and 


redisplays the current image. Note: flip is independent of other commands and may 
be used whenever the user chooses to reverse the orientation of the image plane. 
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5.0 ARCHIVES... 


5.1 INTRODUCTION 


The current image can be written onto an archive, or a stored image may be 
recalled to fill the current image cache. There are several types of image I/O 
devices, among which are Winchester disk, 1/4-inch cartridge tape, and 9-track 
tape. The two tape devices are mutually exclusive so that the same set of 
commands suffices for both. 


5.2 WINCHESTER DISK 
5.2.1 Winchester Disk File System 


5.2.1.1 Images are recorded as single files in the ddata directory. The files are 
given names which are numbers. The number is encoded into a character form, 
and a file name is made of it. This naming process allows image manipulation 
sequences to be engaged using numeric loop counters to index through a 
series of images. 


5.2.1.2 The ddata directory can be initialized (emptied) by ddatainit. If the 
files are all the same size, they can be overwritten without first initializing the 
directory. 


5.2.1.3 Although storage of images as single files is efficient for the typically 
large files that constitute a full CCD image, it is not very efficient for many 
smaller images. A separate system is provided for sequences of smaller images 
(see para 8.7). 

5.2.2 Writing Files to the Winchester Disk 

Data files are written to the Winchester disk by dw; to write the current image to 
disk file 66, enter 66 dw after enabling data recording with +write. (Data 
recording may be disabled with -write.) An image written to an existing disk file 
overwrites the previous contents of that file. 

5.2.3 Retrieving Files from the Winchester Disk 


Data files are retrieved from the Winchester disk by dr. To read image 103 from 
the Winchester disk into the current image cache, enter 103 dr. 


5.3 1/4-INCH AND 9-TRACK TAPES 
5.3.1 Tape File System 


5.3.1.1 On the 9-track tape, an image consists of a 160 byte header, a body of 
data, and an EOF. The data are recorded in 4096 byte buffers so that the tape 
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deck can move the tape efficiently (stream). The last buffer may not be a full 
4096 bytes in length, but all others in the body of the data are that size. 


5.3.1.2 On the 1/4-inch cartridge tape, the header occupies the first 160 bytes of 
one 1024-byte block. The data are divided into 1024-byte blocks, but the 
program locks up during cartridge tape I/O in order to make the device stream. 


5.3.1.3 An image may be overwritten on the 1/4-inch cartridge tape if the new 
image is the same size as or smaller than the original image. The column « row 
size of the image itself is only contained in the header, and is the net size of the 
tape image area that is held in the tape catalog. 


5.3.1.4 When a 1/4-inch or 9-track tape is first used, or if its contents are to be 
erased, it is initialized by the newtape command. At the beginning of the tape, 
newtape records an empty catalog block followed by an end of information 
(EOI) which is two successive end of file marks (EOF). This catalog describes 
the current contents of the tape and is read from the tape into a RAM buffer copy 
at topen; it is updated and written back onto the tape (if the tape was written 
between the open and the close) when the tape is closed at tclose. The CCD 
program only appends images to the end of the 9-track tape at the EOI. 


5.3.2 Writing Files to the Tape Drive 


5.3.2.1 The 1/4-inch tape uses a special cartridge that must be formatted with 
mtformat before use. Formatting takes approximately 40 minutes to complete 
and can be done in advance. Preformatted tapes are available. 


5.3.2.2 Data files are written to tape with tw; to write the current image to disk 
file 32, enter 32 dw after enabling data recording with +write. An image 
written to an existing disk file overwrites the previous contents of that file. 


5.3.2.3 Data files may be added to the end of the tape. It is not possible to 
execute tw using as a parameter an image number that is one larger than that 
of the last image on the tape. Entering tw with no parameter (or with 0 as the 
parameter) appends the image to the end of the tape. 


5.3.2.4 The 1/4-inch tape is rewound and released by unload (with an 
accompanying buzz) so that the tape can be removed. 


5.3.3 Retrieving Files From the Tape Drive 


5.3.3.1 Data files are retrieved from the tape archive by tr. To read image 103 
from tape into the current image cache, enter 103 tr. 


5.3.3.2 Any image may be read from the tape archive. The current position of 


the tape is remembered by the CCD program; it is important not to manually 
rewind the tape or otherwise alter its position while running the CCD program. 
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6.0 PLOTTING 


6.1. The graphics plane in the image display is also used as the default 
graphics plot device. An optional terminal plot device can be used. When the 
program is started, the display is the graphics plot device. If a graphics terminal 
is available, it can be made the graphics plot device by entering tplot. splot 
restores the image display as the plot device. The graphics plane in the image 
display can be turned on by gon, turned off by goff and erased by gz. The 
terminal screen can be erased by page. When the graphics plane is turned off, 
any subsequent graphics activity (such as a cursor) turns it back on, and the 
prior contents are displayed as well as the new information. 


6.2 The program does not save the contents of the graphics memory when the 
cursors are moved about, so a plot can be selectively “eaten” by a roving cursor. 


6.3 Any row or column of the current image can be displayed as a graph of 
pixel intensity versus row or column pixel number: <n> prow plots row n; <n> 
pcol plots column n. Acceptable values of n range from zero to one less than 
the image dimension. In a 320 by 512 image, row 512 does not exist nor does 
column 320. 


6.4 <m> <n> prows plots the average of rows m through n with the same 
constraints upon the values of m and n (they must lie within the bounds of the 
current image). Similarly <m> <n> pcols plots the average of columns m 
through n. The overplot and expansion options are equally applicable to 
multiple row or column plots. 


6.5 With oplot, a plot can be retained while another is drawn over it. The 
overplot status is only valid for the next graphics plot activity. It is possible to 
overplot many times in succession by preceding each plot command by oplot. 


6.6 Given a current plot, it is possible to redisplay the data with a different scale. 
<m> <n> xplot and <m> <n> yplot redraw the current data with m and n as 
the lower and upper plot values, respectively (Figure 6-1). <m> <mm> <n> 
<nn> xyplot expands the graph to both axes (Figure 6-2). 
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The current image is a 400 x 550 


pixel array. The user wishes to view 
column 325 in greater detail. 





The user issues the 325 pcol 
command. The controller responds 
with the plot at left. Column 325 is 
plotted against the displayed image's 
intensity values. Note that the 
orientation of the graphics plane is 
reversed relative to the image plane. 





The user is primarily interested in the 
middle peak and enters 1150 1800 
yplot to enlarge the portion of the 
plot containing that peak to fill 


the screen. The apexes of the other 
two peaks appear to be lowered due 
to truncation of the plot. 





Figure 6-1. pcol followed by yplot 
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The current image is a 400 x 550 


pixel array. The user wishes to view 
column 325 in greater detail. 





The user issues the 325 pcol 
command. The controller responds 
with the piot at left. Column 325 is 
plotted against the displayed image's 
intensity values. Note that the 
orientation of the graphics plane is 
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Figure 6-2. pcol followedby xyplot 
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The user is primarily interested in the 
apex of the middle peak, in particular, 
that region of the previous plot 
bounded by x-axis points 200 and 


250 and y-axis points 1700 and 
1800. To enlarge this area to fill the 
screen, 200 1700 250 1800 
xyplot is entered. 





7.0 IMAGE ARITHMETIC 


Nine commands are provided for performing arithmetic functions upon images. 
These commands are grouped into two sets. The first, constant arithmetic, 
involves the modification of an image by the value of a constant; the second, 
image arithmetic, involves arithmetic activities between two images. 


7.1 CONSTANT ARITHMETIC 


The form of all constant arithmetic commands is identical. <k> function 
applies the constant k to the current image via the specified function. The 
available functions are: c+, c-, c/, and c*. All operate upon the current image 
and return the result to the current image cache. c/ checks for a zero parameter 
and issues an abort message if k is zero. For example, to add the constant 
7000 to the current image, the entry is 1000 c+. 


7.2. IMAGE ARITHMETIC 


7.2.1 The image arithmetic commands all have the form <n> function. The 
available functions are: i+, i-, i*, i/, and i*/. The first four functions require input 
of an image cache number. If the current image is 3 and 2 i- is entered, the 
current image is replaced by the current image minus the image stored in image 
cache 2. 1 i* replaces the current image by the product of the current image 
and the image stored in image cache 1. 


7.2.2 The last function, i*/, involves two parameters in the form <k> <n> 
function. i*/ first multiplies the current image by the constant k, then divides 
that product by the image stored in image cache n. This command allows for 
calibration of an image against a flat field if the value of the constant is chosen 
to have approximately the value of the mean in image cache n. i*/ checks for 
division by zero and substitutes the maximum positive 16-bit integer for a pixel 
when n is zero. 


7.3. MC68020 ARITHMETIC CAPABILITIES 


The 68020 computer has reasonably fast rates of addition and subtraction. 
However, multiplication is approximately eight times slower than addition, and 
division is fifteen times slower than subtraction. Multiplication and division can 
produce some lengthy delays while the i*/ command is executing over a large 
image. 


40 


8.0 IMAGE SEQUENCES. 


8.1 RAM may be used as a buffer to accumulate a sequence of images which 
can be stored as a single image. After <n> seq acquires an image sequence, 
<m> <n> mosaic or <m> <n> movie displays that sequence as a composite 
or series of images, respectively. 


8.2 The steps for use of <m> <n> mosaic or <m> <n> movie follow: 
* <t> obs acquires a full size image; 
* qshow displays that image; 


* Using the mouse, the user positions the box cursor around an area of 
interest; 


* setrec sets up a subimage that is the position and size of the box cursor; 
* clcept clears all image cache specifications; 


* <t> obs acquires the subimage as a model image to provide the 
exposure and array parameters for subsequent images in the sequence; 


* <min> <max> show or qshow displays the model image; 


* nowait, <t> secwait, or trigwait causes the camera to take exposures 
continuously, wait t seconds between exposures, or wait for an external 
trigger event between exposures, respectively. If none of these 
commands is entered, the camera uses either nowait (the default) or the 
last wait command entered. 


* <n> seq acquires into RAM n more images with exposure and array 
parameters identical to those of the model image. The CCD program 
tests to see if the selected number of images can fit into the available 
RAM; the sequence is aborted with an error message if there is 
insufficient space. 


* <m> <n> mosaic or <m> <n> movie displays the resulting sequence 
of images. <m> <n> mosaic displays side-by-side up to n images of a 
sequence that starts with image m (fewer images are displayed if the 
screen is filled before n is attained); <m> <n> movie displays the 
images, one after the other, centered in the video display. 
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8.3 The steps for storage of the sequence of images as a single file follow: 


saveseq converts a sequences of images into a single sequence image 
that is stored in image cache 1. saveseq changes the header of the 
model image so that <#rows> becomes <#rows «+ n>, where n is the 
number of images in the sequence. Once saveseq is executed, the 
ability to examine the original model image as a single image is lost. 


tw and dw record the sequence image on tape and Winchester disk, 


respectively; tr and dr read the sequence image from tape and 
Winchester disk, respectively. 
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9.0 9-TRACK MAGNETIC TAPE FORMAT 


9.1 Record Set Format 


9.1.1 The format of an internal 9-track magnetic tape is illustrated in Figure 9-1. 
The tape is written in record sets with a single tape mark (EOF) separating each 
set. The last record set is followed by two EOFs in succession. 


9.1.2 The tape header consists of three 4,096 byte records. Record 1 in this set 
contains a catalog of the number of records on the 9-track tape. Records 2 and 
3 are empty. Record 1 contains 16-bit integer numbers. The first integer 
number is the total number of EOFs on the tape and is larger than the number of 
image data records on the tape by one. An EOF follows the first record set. 


9.1.3 All remaining record sets are image data record sets. The number of 
records in each set and the size of the last record in each set vary with the size 
of the image recorded. 


9.1.4 All image data record sets have the same structure. The header record is 
160 bytes in length. The remaining data records, excluding the final record, are 
4,096 bytes in length. The length of the final record varies from 2 to 4,096 bytes; 
its length is the remainder when the number of bytes in the image is divided by 
4,096. 


9.1.5 Each image data record set is followed by an EOF. The last image data 
record set recorded on the 9-track tape is followed by two EOFs in succession. 


9.2 Image Header Format 


The image header fills the first 160-byte record in each image data record set. 
The structure of the image header follows as Table 9-1. 
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Tape Header 


First Image Data 
Record Set 


Each Additional Image 
Data Record Set 


+————._ End Mark 


Figure 9-1. 9-Track Magnetic Tape Format 
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Table 9-1. 


Bytes 
1-100 
101-104 
105-111 
112-115 
116-117 
118-119 
120-121 
122-123 
124-125 
126-127 
128-129 
130-149 
150-151 


154-160 


9-Track Magnetic Tape Image Header Structure 


Function 
100 character comment field 
32-bit exposure time in decisecond units 
Empty 
32-bit integer time of image acquisition (UNIX™ time) * 
16-bit origin (columns) of the image on the CCD 
16-bit origin (rows) of the image on the CCD 
16-bit integer image size (columns) 
16-bit integer image size (rows) 
16-bit integer binning (columns) 
16-bit integer binning (rows) 
16-bit integer gain factor at time of image acquisition 
Empty 


16-bit integer image type (0 = bias frame, 1 = dark frame, 
2 = image) 


Empty 


* The number of integer seconds since 0 hr, 0 min, 0 sec of January 1, 1970, 


GMT. 
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10.0 FORTH CCD PROGRAM 


10.1 PROGRAM STRUCTURE 


10.1.1 The CCD program is highly interactive. There is no batch mode, and 
background activities are not supported. Users can augment existing 
commands with those of their own making. Useful sequences of standard 
commands can be combined into special macro commands which are tailored 
to a particular situation. The user also can change any portion of the CCD 
program. 


10.1.2 The program is coded in FORTH, which allows user access to every 
FORTH word in the dictionary. Most of the words in a FORTH dictionary are 
intermediate steps in a generalized process. The primary commands are listed 
in the attached glossary. 


10.1.3 The program is contained in files which are modularized to the functions 
they fulfill. A different capability in one aspect of the program should not affect 
other areas. The exception is the image display, which is also used as the 
graphics display. ; 


10.1.4 A major aspect of the program design is the utilization of memory as a 
scratch-pad image area. The memory is allocated into a maximum of 64 
contiguous areas, or image caches. The size of an image cache is not 
determined until that image cache is used. All image activities involve the 
current image cache. The user can specify which image is considered current. 
Typical procedures include: 


* Acquisition of an image from the detector; 

* Examination of an image by plotting rows or columns; 
¢ Displaying an image on the monitor; 

¢ Performing a calibration sequence; and 

* Recording an image on a disk or tape. 


The user can switch to any defined and specified image cache, or to an 
unspecified image cache one digit larger than the last defined image cache up 
to a total of 64 images. 


10.1.5 The structure of a Photometrics image is a 1024-byte header space 
followed by the image domain. The header is fixed in size and contains all of 
the parameters relevant to the image as well as the user-entered information. 
The header contains the parameters that define the size of the image area that 
follows. In the Photometrics FORTH system, image row length is equal to the 
number of columns and image column length is equal to the number of rows. 
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10.2 FILE SYSTEM 


10.2.1 When the system is loaded, the program switches to the directory that 
contains the camera control code. All of the different commands in the program 
are contained in files in this directory. Several directories are defined, including 
tape data and disk data. It is usually not necessary to change directories; 
however, to do so, the command dir <directory name> searchs the directory 
list for the name of the specified directory and makes it the current directory. To 
display the name of the current directory, type dir?. Directories are linked, soa 
file name search can span several directories. This linking is specified when 
the directory is created. The tape and disk data directories are linked only to 
themselves so that data file name searches are limited to the appropriate space. 


10.2.2 A new file is made with <n> fcreate <filename> where n is the 
number of blocks allocated to the file and <filename> is the name of the file to 
be created. The first contiguous group of free or empty blocks on the disk are 
allocated to the newly created file. An error message is returned if not enough 
disk space is available to satisfy n. (fempty? displays the number of empty and 
free blocks available.) 


10.2.3 fdelete <filename> deletes a file, where <filename> is the name of 
the file to be deleted. ; 


10.2.4 Files are entries in a directory. These entries consist of: a name, a 
physical disk location, and a size in blocks. Typing file <filename> causes a 
search to occur for that file; if located, the file is opened and made the current 
file. This attribute is used more in programming than in data acquisition 
activities. All of the data sets on the disk are files and are accessed through the 
file system. For this reason, standard file operations can be used to manipulate 
the disk and tape data directories. 


10.2.5 Program source files are loaded (compiled by FORTH into the 
dictionary) by typing If <filename>, where <filename> is the name of the 
desired file. 
10.2.6 The user wishing to scan the contents of a file should enter: 

dir camera file <filename> <n> list 
where filename is a file name and n is the block within that file. The named 
file becomes the current file, and all of the blocks within that file are now 
accessible by the list command. For example: 

dir camera file Ip 0 list 
lists block 0 of the file Ip. The numbers are relative to the beginning of the file 


because a filename other than nofile was specified. The file system aborts if 
the user attempts to access a block outside the range of the current file. 
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10.2.7 When the system has just been loaded, no file has been selected and 
the current file is called nofile. When the current file is nofile, all of the blocks 
can be accessed directly. If a file is declared, then only blocks inside the range 
of blocks encompassed by the file are accessible. They are referenced as 
blocks 0 to 1 less than the length of the file. To return to nofile as the current 
file, enter file nofile. 


10.3 PROGRAM FILES 


10.3.1 The program is contained on the disk as source block images which are 
compiled into the computer as they are accessed. The program is contained ir 
32 files. The program is loaded by one master file called CCD. The FORTH 
command to load a program file is If <filename>, which causes that file tc 
begin compiling. A file can load other files, and the CCD file principally performs 
that function. 


10.3.2 The CCD program is divided into files which support the camera 
activities. These files are all resident in a directory called camera. The files are: 


utilitiA” Photometrics FORTH extensions and tools 
ed Photometrics line editor 

filesys File system 

Ip Printer port for HK68 SBC 

fprint File print routines 6-block and 3-block 
idm Image data manager for files and chases 
sc Scan converter routines 

scplot Scan converter plot package 

aops Array operations 

calib Calibration and test sequences 

cursor Grapics and image cursors 

ccd Basic CCD loader 

cart-tape 1/4-inch cartridge tape device driver 
stty Terminal-specific attributes 

terplot Graphics terminal plotting 

tdi Time delay integrator file 

init System initialization 

demo demonstration program 

plots User level graphics plot commands 
movie Multiple image display , 

stats Activities that follow the graphics box cursor 
schars Table of bits for alphanumerics 

hist Histogram routine 

thdrs Tape headers, tape lists 

mouse Mouse drivers for graphics cursors 

user user parameter checking redefinitions 
old-tape. Basic tape interface -- SCSI 

comm tty2 device driver 

chars SC alphanumeric display 

tmonitoA Terminal status line display 
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Pore 


old-sctape SCSI/9-track tape hi-level support . 


clkcal Time/Date input, printing, events 
fdisk Floppy disk file archive 
npmccd CCD hardware drive 


10.4 FORTH AND EDITORS 
10.4.1 FORTH Editor 


10.4.1.1 FORTH text is contained in blocks. The Photometrics editor is a line 
editor which operates either on absolute blocks or on blocks inside of files. The 
Photometrics editor vocabulary is maintained separate from the general FORTH 
commands. To enter the Photometrics editor vocabulary, enter editor. Entering 
editor causes the FORTH vocabulary, including the CCD program commands, 
to be ignored. To return to the regular FORTH vocabulary, bypassing the 
editor commands, enter forth. Once inside the editor, a block can be 
displayed by entering file <filename> <n> edit, to edit block n of file 
filename. This command sequence displays block n upon the screen. At this 
point, the following line editing commands are available (<l#> specifies a line 
number): 


<l#> d delete 

<l#> e erase 

<l#> b begin entering text 

<l#> t type the line to enter the line into the one line text buffer 
<l#>_h hold the line in the text buffer 

<l#> j insert the contents of the text buffer after the specified line 
<l#> r replace the specified line with the current contents of the 


text buffer 
<l#> m modify the indicated line 


<l#> bi begin inserting: lines below the specified line number are 
pushed down; lines that fall off the bottom of the block are: 
lost 

<I#> il insert lines from another block that have been held by an hl 


command as described below. 


The il command is inactive for lines from within the current block or.on lines 
from another file. 


10.4.1.2 A number of commands. are available that require the input of two 
parameters: 


<l#1> <I#2> dl delete lines 
<l#1> <I#2> el erase lines 
<l#1> <l#2> hi hold lines 


“The hl and il commands work together across blocks within a file but not for 


lines within the same block. To edit across files, it is usually best to specify file 
nofile and hold lines in absolute block space. To move lines within a block, the 
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text buffer can be used to move one line at a time, or the entire block can be 
copied to another location and then the desired lines extracted using hl. 


10.4.1.3 The m command is very powerful and somewhat complicated. It 
operates on the specified line (which is termed the old line) and upon an image 
of the new line that is constructed by the user using the cursor. The function of 
m is to copy the old line to the new line while permitting modifications to be 
made in the process. When the end of the new line has been reached, the new 
line is copied back into the block, replacing the old line. 


10.4.1.4 When the m command is executed, the specified line is displayed at 
the bottom of the screen. The cursor is positioned at the first character. As the 
cursor is moved along the line (by typing the space bar), characters are copied 
from the old line into the image of the new line, displayed below the old line. 
Any typed character, other than the space bar, replaces the current character in 
the old line with the character typed into the new line. The cursor lives in the 
current line (old or new). The ESC key toggles the cursor between the two 
lines. When the cursor is in the new line, all characters typed are new and are 
entered into the new line (including the space key). If the new line becomes full 
in this process, the m command is terminated, and the new line is written back 
into the block. If the cursor is returned to the old line, characters may continue 
to be moved to the new line, but they are entered at the end of the line. 


10.4.1.5 While in the old line, the DEL (or RUB) key deletes characters from 
the old line without entering them into the new line. When in the new line, the 
same key backspaces the cursor over previously-entered characters. A number 
of special characters are interpreted within the m command: 


Aw Ad Ai Ab Af Ak Au, 


where 4 symbolizes typing the character while holding the CTRL key at the 
same time. All of these commands are accepted as typed without the carriage 
return key. In fact, the carriage return key is interpreted as an instruction to fill 
out the new line with the remaining characters from the old line (if the cursor 
was in the old line), or to finish the new line with blanks if the cursor was in the 
new line. The CTRL/character commands only work with the cursor in the 
old line because they all act upon groups of characters at a time. “w copies 
the next blank delimited string into the new line; 4d deletes the next blank 
delimited string. 


10.4.1.6 Ab inserts a blank into the new line; “i copies the next eight 
characters (actually “i also works in the new line to insert eight blanks). Af and 
Ak wait for an ensuing character and move the cursor to the next occurrence of 
that character. Af copies all of the intervening characters into the new line, 4k 
deletes all of the intervening characters. Failure to find the key typed causes an 
error warning (beep). 4u cancels the current changes to the new line; a second 
u in succession (i.e. with no new line characters to cancel) cancels the current 
m command. After a little experience with the m command, the options become 


’* more natural. 


if 
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10.4.1.7 The b command (begin) overwrites the specified and all subsequent 
lines entered by the user. Au terminates this entry activity. A new block can be 
filled by starting at line 1 (1b). Any lines not overwritten contain their prior 
contents when the begin activity is terminated by Au. 


10.4.1.8 To enter held lines beginning with the first line, it is permissible to type 
Oil. In fact, the sequence to copy a block is to execute: 


n edit 116 hI m edit Oil 
where m and n are different block numbers within the same file. 


10.4.1.9 To list the current block again, enter I (for list). To alternate quickly 
between two different blocks in the same file, the alternate command displays 
the contents of the hidden (alternate) block. 


10.4.1.10 When an editing session is finished, it is necessary to exit the editor 
vocabulary by typing forth. In addition to switching vocabularies, this command 
also flushes to disk any updated (changed) blocks. If the program is exited 
without flushing the changes back onto the disk source file, they are lost. In this 
vernacular of FORTH, such a loss can be significant because there are four 
block buffers, and it is conceivable that four blocks could be edited and, if not 
flushed, lost. 


10.4.1.11 The editor is routinely loaded when the CCD program load occurs. It 
is loaded after the file system is created so that it can utilize program files. 


10.4.2 loFORTH Editor 

10.4.2.1 To run the basic lo Inc. FORTH environment without the Photometrics 
camera commands, file system, or line editor, enter 26 load after you enter bw 
to boot the system. Then enter ioeditor load. ioeditor runs only on Adam 
and Televideo-type terminals that use ESC =. 


10.4.2.2 The loFORTH screen editor may be used by loading it into the FORTH 
vocabulary with the command sequence file nofile 102 load. 


10.4.2.3 The command discard removes from the FORTH vocabulary the 
loFORTH screen editor and anything loaded or defined after the 102 load. 
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11.0 UTILITIES AND SYSTEM REBUILDING 


11.1. BOOTSTRAP 


A hardware ROM provides a terminal monitor utility that can bootstrap from 
either the Winchester disk or floppy disks. The full capability of this monitor is 
described in the Heurikon HBUG User's Manual. bf reads a bootstrap program 
from floppy disks, whereas bw reads it from the Winchester disk. Although it is 
much faster to run the FORTH operating system from the Winchester disk, the 
system can be run from floppy disk, if necessary. 


11.2 BACKUP 


11.2.1 backup copies the FORTH program files and disk directory blocks 
stored on the Winchester disk to two 5 1/4-inch floppy disks. FORTH must be 
running on the Winchester disk to use backup. If FORTH is not running, boot 
the computer with bw and enter 25 load. Floppy disks made with backup that 
contain the FORTH operating system can be used for FORTH installation (24 
load) or for backup program recovery (recover). Because backup uses the 
CPU memory, all CCD program codes are discarded to obtain a large buffer. 


11.2.2 With the write-enable tab removed, format two 5 1/4-inch floppy disks 
with the command ffmt. Enter backup. The computer prompts for insertion of 
the first disk followed by-a carriage return. Enter only one carriage return; entry 
of a second carriage return at this point overwrites the blocks written onto the 
first floppy disk with the blocks intended for the second floppy disk. backup 
transfers Winchester disk blocks 0-719 onto the first disk. backup then prompts 
for the second disk, onto which it transfers blocks 720-999, starting at floppy 
block address 0. To return to the CCD program after backup, reboot the 
system and execute 25 load. 


11.3 RECOVER 


11.3.1 recover copies the FORTH program files and disk directory blocks from 
the two backup floppy disks to the Winchester disk. 


11.3.2 FORTH must be running on the Winchester disk to use recover. If 
FORTH is not running, boot the computer with bw and enter 25 load. 


11.3.3 Enter recover. The computer prompts for insertion of the first disk 
loaded with the FORTH operating system, followed by a carriage return. Enter 
only one carriage return; entry of a second carriage return at this point transfers 
blocks from the first floppy disk twice. recover transfers blocks 0-719 from the 
first disk. recover then prompts for the second disk, from which it transfers 
blocks 720-999, starting at floppy block address 0. To return to the CCD 
program after recover, reboot the system and execute 25 load. 
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11.4 INSTALLING STANDALONE FORTH FROM THE BACKUP 
FLOPPY DISKS . 


11.4.1 After booting the system with bf, enter 24 load to install FORTH from 
the two backup floppy disks onto the Winchester disk. The computer prompts for 
a backup floppy disk. If the boot disk is also the first backup floppy disk, press 
the carriage return. Otherwise, place the first backup floppy disk in the disk 
drive and press the carriage return. The computer then prompts for the second 
backup floppy disk. 


11.4.2 When FORTH has been successfully installed, the computer so indicates 
with a message. The computer can now be booted from the Winchester disk. 


11.5 REBUILDING THE WINCHESTER DISK 


11.5.1 If the computer has a regular or recurrent problem, the Winchester disk 
may need to be rebuilt. The UNIX™ Winchester disk formatting facility is used to 
format the disk. This facility is described in Section 12.1 of the Heurikon System 
V UNIX User's Manual. 


11.5.2 The installation of FORTH on the Winchester disk overwrites UNIX™ 
boot blocks with FORTH boot blocks. Once FORTH is installed on the 
Winchester disk with 24 load, UNIX™ can no longer be booted. 


11.5.3. To rebuild your Winchester disk from floppy disks, follow steps 1 through 
17 in Section 12.1 of the Heurikon System V UNIX User's Manual. After step 17 
is completed, the system prompt reappears. Insert the Standalone FORTH 
floppy disks, boot the computer with bf, and enter 24 load. 


53 


ve 


12.0 FORTH : 


12.1 ABORTS 


FORTH freely emits aborts. Aborts always terminate the current activity and 
drop everything that was on the stack. An abort also causes all of the rest of the 
commands on the current input line to be skipped and control to be returned to 
the user. Aborts are not catastrophic events. If one occurs in the middle of a 
sequence, it may be very inopportune, but it does not mean that the computer 
program must be reloaded. An abort does mean that the activity in progress is 
lost. If the camera is exposing and the user is performing some activity that 
produces an abort, the camera is unaffected. 


12.2. THE BINARY IMAGE 


12.2.1 A fast load from a binary image is provided by entering 25 load after 
the boot command. This method uses a previously compiled version of the 
program that was saved as a binary image. To change the binary image, 
bootstrap and execute 30 load to compile the entire image from source. Test 
the code, then add any other commands or file loads that-are appropriate. 
Finally, save the image of all that has been entered into the dictionary. 


12.2.2 The binary image is entered into blocks starting at 200. The program 
aborts if the binary image exceeds 100 blocks. A number of different binary 
images can be created and saved (for example, on floppy disks) to be copied 
into the binary image file for use on special occasions. savebin copies a 
compiler dictionary from memory to the disk; subsequent entry of 25 load 
commands load this binary image. 


12.3 SYSTEM COMMANDS 
12.3.1 Time 


12.3.1.1 Clock time is provided by a clock module connected to the computer 
processor. Interval time is obtained by a CPU interrupt service request that 
occurs every ten milliseconds. Time is maintained to a precision of one 
millisecond and is updated every ten milliseconds. 


12.3.1.2. The current time is listed in integer seconds since 00:00:00 GMT, 
January 1, 1970, as defined in the UNIX™ User's manual under the ctime (3) 
function. 


12.3.1.3 To set the current date in the clock module, enter endate <mmddyy>, 
where mm is the month, dd is the date, and yy is the year. To set the current 
time, enter entime <hh:mm:ss>, where hh is the hour, mm is the minute, and 
ss is the second. You must enter the parameter in Greenwich Mean Time. The 
clock module can then be set with the command setclock. 
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12.3.1.4 The clock module is read automatically each time the CCD program is 
started up. . 


12.3.1.5 Two time registers are maintained and can be accessed by user 
commands. The current time register is set to the time read from the clock 
module. 


12.3.1.6 The first register is the interrupt service register. The variable time, 
accessed by the command time ?, provides this register's current value. This 
value represents the number of 10-millisecond ticks that have occurred since 
the last time the computer was started by bootstrapping FORTH. It is a 32-bit 
unsigned integer that overflows after 50 days of continuous operation. 


12.3.1.7 The second register is the clock time register. The 32-bit unsigned 
integer variable, $tdate, accessed by $tdate ?, provides the number of integer 
seconds that have elapsed since 00:00:00 Greenwich Mean Time on January 1, 
1970. This the UNIX™ definition of the beginning of time and is used in 
Photometrics 3000 FORTH to permit the transfer of data files between FORTH 
and UNIX™ systems. 


12.3.1.8 The $tdate parameter is inserted automatically into the header of 
each image file when a file is created by an obs, dark or bias command. The 
time is not entered into the header when an image is created by the command 
fset. The time is read with the header of an image retrieved from an archive. 


12.3.1.9 If the clock module produces an erroneous output, the time and date 
accessed by $tdate ? will not be correct. Occasionally the erroneous value 
will be outside of the range of values handled by the date processing logic. 
When this occurs, the computer reports that error #95 has occured. The 
command newdate resets the clock module. newdate prompts for the date in 
the form mmddyy, followed by a prompt for the time in the form hh:mm:ss. 
prdate and prtime print the current date and time, respectively. 


12.3.1.10 <n> ms enters into an n millisecond delay that is accurate to within 
10 milliseconds. Values of ten or less delay until the next 10-millisecond tick. n 
is added to the current value of the variable time. The computer hangs up in a 
loop that tests the current time value, exiting the loop when the current time 
value exceeds the sum of the initial time value plus the current value of n. The 
command 500 ms causes a delay of one-half second. 


12.3.1.11 To time the duration of a command, the sequence 

time @ <xxxx> time @ swap -. 
reads the time, executes xxxx, where xxxx represents any valid sequence of 
previously defined FORTH commands, reads the time again, subtracts the first 


time reading from the second time reading, and prints the difference. The 
integer value returned is printed in milliseconds. 
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12.3.2 Looping Constructs 


12.3.2.1 FORTH provides two loop control structures that can be used to 
execute commands or command sequences repeatedly. The first is the FORTH 
construct DO <xxxx> LOOP, where xxxx represents any valid sequence of 
previously defined FORTH commands. The construct must be compiled into a 
FORTH definition; DO and LOOP cannot be executed directly. 


12.3.2.2 The following is a typical camera control loop that reads out an image 
of a fixed exposure from the camera into the current image cache and displays 
that image on the monitor for ten cycles: 


myloop 10 0 DO 3 obs qshow LOOP ; 
12.3.2.3. The second looping construct, BEGIN END, runs until some 
condition, such as the striking of any terminal key, occurs to terminate the loop. 
The following is a typical camera control loop that reads an image of a fixed 
exposure from the camera into the current image cache and displays that image 
on the monitor until the loop is terminated: 

yourloop BEGIN 3 obs qshow key? END ; 


12.3.2.4 BEGIN END constructs must be compiled into the dictionary; they 
cannot be executed directly from the terminal. 
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13.0 EXTERNAL TRIGGER CONTROL 


13.1 The Photometrics 3000 system configured with the FORTH software can be 
made to respond to an external synchronization signal. This feature is valuable 
when this system is employed for laser pulse diagnostics, streak tube camera 
readout, and other applications where the optical input is of transient nature. 


13.2 In typical applications, the external trigger aids in recording transient 
optical phenomena when the timing of the event cannot otherwise be 
controlled. Before the event occurs, the camera shutter should be opened with 
oshut and a continuous clear (cisc) command issued. At this point, the 
camera controller is continuously executing the cisc task, and the camera 
controller's task-in-progress bit is set. The trig command is then issued to 
cause the system's processor to loop until the external trigger occurs. Until the 
event does occur, the ambient light level should be kept as low as possible. 
Clearing a CCD is not an instantaneous process and all light falling on the CCD 
is integrated for a few milliseconds. 


13.3 When the external trigger line is pulled low, cise immediately terminates 
and the camera controller's task-in-progress bit is cleared. The CCD integrates 
light until the shutter is closed. The computer senses that the trigger was 
initiated by testing the controller task-in-progress bit. The computer does not 
exit the trig loop, however, until it senses that the external trigger line has gone 
high again. This feature allows two methods of controlling the integration time 
for the transient optical event: the signal causing the trigger to occur can dictate 
the integration time (timing by external device) or the computer can execute a 
programmed delay (timing under program control). 


13.3.1 The TTL signal that initiates the external trigger can also be used to 
control the optical integration time. The external trigger line must simply be held 
low for the duration of exposure. In the program controlling the experiment, a 
close shutter command (cshut) follows trig. cshut is not sent to the camera 
controller until after the computer senses that the external trigger has been 
restored to TTL high. The CCD may now be read out by readout. An example 
of a programmed sequence to record a transient optical event in this manner 
follows: 


: catch-flash oshut cisc trig cshut readout ; 


13.3.2 To time the exposure, <n> ms follows trig, where n is the number of 
milliseconds to pause for optical integration. cshut immediately follows to 
close the shutter to ambient light. Next, the CCD may be read out by readout. 
In this mode of operation, the external trigger signal should be of short duration, 
as the millisecond timer will not start until the trigger line has returned high. An 
example of a programmed sequence to record a transient optical event for 50 
milliseconds in this manner follows: 


: Catch-flash oshut cisc trig 50 ms cshut readout ; 
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13.4 The external trigger can also be used for frame transfer purposes. An 
example of a programmed sequence to record a transient optical event in frame 
transfer mode follows: . 


: Catch-flash trig 2 fobs ; 
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14.0 HEADER BLOCK DEFINITIONS 


The following table describes the allocation of image header bytes in RAM or on 
an archive. A 1/4-inch tape header fills one entire 1024-byte block; the headers 
for 9-track tape are 160-byte records. 


The time is listed in integer seconds since 00:00:00 GMT, January 1, 1970, as 
defined by the UNIX™ manual under the ctime function. Photometrics software 
provides tools to convert this form into other date representations. 


Bytes [#] Offset [Bytes] Function 
100 (max.) 0 Comment 
4 100 Length of exposure 
(deciseconds) 
8 104 Pad 
4 112 Time of header creation 
(seconds) 
2 116 Image origin (column) 
2 118 Image origin (row) 
2 120 Column length 
2 122 Row length 
2 124 Column binning 
2 126 Row binning 
2 128 Gain factor 
20 130 Pad 
2 150 Image type 
8 152 Pad 
ss 1024 Image data area 
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PART 2. 
CCD PROGRAM COMMAND REFERENCE 


Prep ge mint 


1.0 COMMAND CONVENTIONS 


14.1. When the load sequence finishes, all of the commands listed in the 
attached CCD Program Command Glossary are available. Commands are 
entered in reverse Polish notation (RPN) in which parameters precede 
commands. 


1.2 The FORTH CCD program accepts type-ahead but does not echo the 
characters until a new line of input is accepted by FORTH. Multiple commands 
on one line are permitted if separated by a space. For example, 


gz <cr> 
pz <cr> 
2 sq <cr> 


is functionally equivalent to 
gz pz 2 sq <cr>. 


1.3 The FORTH CCD program prompt is a backslash character, \. The program 
aborts if an unrecognized command is entered. An abort is "soft," and causes 
the remaining characters in the terminal input buffer to be ignored and the 
parameter stack to be cleared. Aborts have no impact upon the camera system 
or the program's current load image. 


1.4 FORTH does not "clean the stack" at the end of each command. This can 
cause the inadvertent use of meaningless parameters if the user omits a 
parameter required by the current command. If the stack is empty, most 
commands issue a message and abort for insufficient parameters. It is 
permissible, for example, to execute the decimal point command, ., which prints 
the top value on the stack. If the stack is empty, FORTH issues an abort 
message to state that the stack is clean. 


1.5 The terminal interrupt key is CTRL z, Az. 
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2.0 CCD PROGRAM COMMAND GLOSSARY 


Note: Command parameters are listed between brackets as <parameter>. 


+auto 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Enable the autoplot range feature. 
None 

None 

This is the program default state. 


+auto renders subsequent plots with both upper and lower 
limits set by the range of the data. 


Reference: See -auto. 


-auto 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Reference: 


Disable the autoplot range feature. 
None 
None 


-auto renders subsequent plots with a lower limit of zero even if 
the data have a negative lower range. 


See +auto. 
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backup 


Purpose: 


Parameters: 
Prerequisites: 


Notes: 


Reference: 


bias 
Purpose: 
Parameters: © 


Prerequisites: 


Notes: 


Back up the program source code blocks (0 - 999) from the 
Winchester disk onto two 5 1/4-inch preformatted floppy disks. 


None 

None 

backup transfers the initial 720 blocks onto the first floppy disk, 
then prompts for the second floppy disk onto which it transfers 
the final 280 blocks. The user must identify the order of the 
floppy disks, because they must be loaded (by recover) in the 
same order in which they were created. 

The first floppy disk can serve as a bootable disk and can run 
the entire CCD program if the Winchester disk is nonfunctional. 
In this event, data can be recorded only to a 1/4-inch cartridge 
tape. The floppy disk backup contains all of the file system 
attributes required to support this mode of operation. 


See recover. 


Read the electronic bias on the CCD to allow measurement of 
the intrinsic CCD background level. 


None 
None 


bias clears all charge from the CCD and immediately reads out 
the CCD into the current image cache. 
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é Purpose: 


Parameters: 


Prerequisites: 


Notes: 


; <k> c* 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


binning 

Set the binning parameters that specify the combination of 
columns and/or rows to be combined in the next CCD readout. 
<c> is the column binning parameter 

<r> is the row binning parameter 

None 

For either columns or rows, the sum of the origin plus the 
binning multiplied by the number of pixels read must not exceed 
the column or row length of the CCD. If the CCD size is 
exceeded, the computer issues an error message and ignores 
the command. 

Binning must be specified when the camera head is set to read 
out a full image (after default is issued or when the CCD 
program is first started). 


Binning is set to 1 by default. 


Multiply the contents of the current image cache by a constant, 
leaving a 16-bit integer in the current image cache. 


<k> is an integer between -32768 and +32767. 
A current image must previously have been specified. 


The data overflow if the product exceeds +32767. 
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<k> C+ 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


<k> C- 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


<k> C/ 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Add a constant to the contents of the current image cache, 
leaving the results in the current image cache. 


<k> is an integer between -32768 and +32767. 
A current image must previously have been specified. 


The data overfiow if the sum exceeds +32767. 


Subtract a constant from the contents of the current image 
cache, leaving the results in the current image cache. 


<k> is an integer between -32768 and +32767. 
A current image must previously have been specified. 


The data overflow if the results exceed +32767. 


Divide the contents of the current image cache by a constant, 
leaving the results in the current image cache. 


<k> is an integer between -32768 and +32767. 
A current image must previously have been specified. 


A zero divisor must not be used; an abort message is issued in 
the presence of a zero divisor. 


The data overflow if the results exceed +32767. 
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ccd 
Purpose: 


Parameters: 


Select the CCD that is in the camera head. 


None 


Computer Response: Computer displays a list of CCDs and prompts for 


Prerequisites: 


Notes: 


Reference: 


<m> <n> 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


selection 
None 


ccd defaults to the CCD type that was shipped with the system 
in use. 


format displays the format of the CCD chosen by ced. 


See format. 


<C> <I> <p> <q> ccdfmt 


Set up explicitly the portion of the CCD array to be read out at 
the next CCD readout. 


<mp> is the column offset 

<n> is the row offset 

<c> is the number of columns to be read 
<r> is the number of rows to be read 
<p> is the column binning 

<q> is the row binning 


None 

For either columns or rows, the sum of the origin plus the 
binning multiplied by the number of pixels read must not exceed 
the column or row length of the CCD. If the CCD size is 
exceeded, the computer issues an error message and ignores 
the command. 


Unlike !fmt, cedfmt executes a clept command to clear the 
image table in RAM. 


See !fmt, binning. 
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<n> cgain 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


<n> ci 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


Set the gain parameter in the header of the current image so 
that the next image acquisition command uses that parameter 
as the readout gain. 


<n> is an integer between 0 and 4095. 

None 

<n> cgain changes the readout rate and sets the gain for 
camera heads equipped with the slow analog processing card. 


Only the readout rate is changed for camera heads equipped 
with the fast analog processing card. 


The default gain is zero. 


Select an image cache as the current image cache. 
<n> is an integer 


An image cache must be defined before it may be selected as 
the current image cache. An image cache is defined when it is 
one integer larger than the last image cache provided with 
column and row size specifications. 


Image cache column and row size must be acquired from the 
camera, Winchester disk, or tape, or be specified by <c> <r> 
fset before image arithmetic or other image manipulations can 
be undertaken. <c> <r> fset can specify the size of an image 
cache explicitly if the current image is the last image in RAM. 


Image cache 1 is always defined and, thus, available to be the 
current image cache. 


An error message is produced when column and row size are 
specified for an undefined image cache. 


See <c> <r> fset 
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cisc 
Purpose: 
Parameters: 


Prerequisites: 


clept 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 





Continuously clear the CCD array. 
None 


None 


Remove all image cache definitions in RAM. 
None 
None 


clcpt empties the table of images without erasing the data area 
and permits redefinition of the image caches. (An image cache 
is defined when it is one integer larger than the last image 
cache provided with column and row size specifications.) The 
original image cache headers are removed. The current image 
cache is defined to be image cache 1, which is empty. 


Use this command with caution, because once the table of 
images is cleared, headers of previously specified image 
caches cannot be retrieved. 


Previously specified image caches are not erased and can be 
recovered by <c> <r> fset. 
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clear 


Purpose: 
Parameters: 


Prerequisites: 


<n> clist 
Purpose: 


Parameters: 


Prerequisites: 


Reference: 


Clear the contents of the current image cache to zero. 
None 


None 


List the pixel values in column n of the current image. 


<n> is an integer that is smaller than or equal to the number of 
columns in the current image. 


A current image must previously have been specified. 


See rlist. 
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clrims 

Purpose: Clear the CCD array. 

Parameters: None 

Prerequisites: None 

Notes: clrims is automatically executed by the computer to clear the 
CCD of residual charge prior to integration of dark current (<t> 
dark command), reading of DC offset (bias command), or 
acquisition of an image (<t> obs commana). 


clrims is used in conjunction with other camera control 
commands to take special exposure sequences. 


comment 

Purpose: Enter a comment into the header of the current image. 
Parameters: None 

Computer Response: The computer prompts for entry of a comment. 
Prerequisites: None 

Notes: The comment entered may be 100 characters in length and is 


displayed by the next <gmin> <gmax> show or qshow 
command. 
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creset 
Purpose: Reinitialize the camera controller. 
Parameters: None 


Prerequisites: None 


cshut 
Purpose: Close the shutter. 
Parameters: None 


Prerequisites: None 


Notes: oshut opens the shutter. 
<t> dark 
e 
Purpose: Initiate an exposure without opening the shutter. 
. Parameters: _<t> is an integer between 2 and 167,771 (4.7 hours) 


Prerequisites: None 


Notes: <t> dark closes the shutter, clears the CCD array twice, 
integrates the CCD dark current for t deciseconds, and reads 
the CCD out into the current image cache. 


( ? 
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“ ddatainit 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


default 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


G 


Initialize the data directory on the Winchester disk. 
None 
None 


Use this command with caution, because it erases the 
existing data directory. 


Reinitialize the computer parameters. 

None 

None 

default sets the gain to zero, initializes the readout format to 
the full CCD array using the detector specifications set by ced, 
eliminates all binning, and sets the display parameters to their 
default configurations. 


default discards all image caches. 
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<t> delay 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Wait t milliseconds before taking the next exposure. 
<t> is a parameter between 0 and 4 x 109 


None 


delay can be used for special exposure sequences. 


dir <directory name> 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


<n> dr 


Purpose: 


Parameters: 
Prerequisites: 


Notes: 


Specify a directory to be the current directory. 
<directory name> is the name of the specified directory 
None 


dir issues an abort if the specified directory does not exist. 


Read an image file from the Winchester disk into the current 
image cache. 


<n> is the number of the current image cache 
None 


The image size is taken from the header, which is read into the 
current image cache header structure. 


If the image cache is defined but unspecified, <n> dr creates 
the column and row size specifications. 


If the file does not exist, if the current image cache is already 
specified, or if the current image cache is specified, but is the 
wrong size, an error message is given and the activity is 
cancelled. 
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<n> dw 


Purpose: 
Parameters: 


Prerequisites: 


Notes: 


expose 


Purpose: 


Parameters: 
Prerequisites: 


Notes: 


Write the contents of the current image cache to a Winchester 
disk file. 


<n> is the number of the Winchester disk file. 
+write must precede dw. 
A current image must previously have been specified. 


If the specified file already exists, it is opened and written over, 
unequivocally. 


Initiate a user-timed object exposure by clearing the CCD and 
opening the shutter. 


None 
None 


readout terminates the exposure and reads out the CCD. 


<n> extract 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Create a subimage that is the position and size of the graphics 
box cursor. Enter this subimage into image cache n (if that 
image cache is the right size) or at the end of the currently 
specified image caches, if no parameter is given. 


<n> is a defined image cache. (An image cache is defined 
when it is one integer larger than the last image cache provided 
with column and row size specifications.) 

A current image must previously have been specified. 


The image cache that acquires the subimage becomes the 
current image cache. 
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fast 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Reference: 


fbias 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Reference: 


Change the readout rate to fast. 
None 
None 


Hardware and software readout rates must both be set to fast, or 
a nonsense image results. 


See slow. 


In frame transfer mode, read the electronic bias on the CCD to 
allow measurement of the intrinsic background level. 
None 


The CCD must be in frame transfer mode (frame command). 
fbias clears all charge from the CCD, reads out the storage 
array into the current image cache, and causes the CCD to clear 
continuously until the next image acquisition command is 
executed. 


See frame. 
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file <filename> 


Purpose: 


Parameters: 


Prerequisites: 


<t> flash 
Purpose: 
Parameters: 


Prerequisites: 


flip 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Search the open file table, the current directory, then the 
directory path for the specified file. If that file is found, it is 
opened as the current file. 

<filename> is the name of the specified file. 


None 


Turn on the flashring for t milliseconds. 
<t> is an integer between 0 and 4095. 


None 


Reverse the orientation of the image plane from left to right. 
None 
None 


A second execution of flip restores the image plane to its 
original orientation. 


qshow, sho, or <gmin> <gmax> show display the flipped 


image (sho requires the entry of a previous <gmin> <gmax> 
show command). 
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flist 

Purpose: Display the contents of the open file table. 

Parameters: None 

Prerequisites: None 

Notes: flist displays the entire 16-entry table with file names or blanks 
at each entry and displays the name of the current directory with 


the current file as a header. 


References: See fis, fis-l. 


<n> fload 
Purpose: Start loading from the current file at the specified block. 
Parameters: <n> is the specified file block at which the load begins. 


Prerequisites: None 


Notes: file <filename> 0 fload is functionally the same as If 
<filename>. 
Reference: See If. 
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fils 


Purpose: 
Parameters: 
Prerequisites: 
Notes: 


References: 


fls-l 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


List the names of the files in the current directory. 
None 

None 

fls displays file names only. 


See flist, fls-l. 


Display the files in the current directory 
None 
None 


fls-I displays file names, contents of the 0-lines, file lengths, 
and file offsets. 


77 


<Mm> <N> <C> <I> <p> <q> !fmt 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


<t> fobs 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Set up explicitly the CCD area to be read out at the next CCD 
readout. 


<m> is the column offset 

<n> is the row offset 

<c> is the number of columns to be read 
<r> is the number of rows to be read 
<p> is the column binning 

<q> is the row binning 


None 

For either columns or rows, the sum of the origin plus the 
binning multiplied by the number of pixels read must not exceed 
the column or row length of the CCD. 


Unlike ccdfmt, !fmt does not execute a clcpt command to clear 
the image table in RAM. 


See also ccdfmt, binning. 


In frame transfer mode, initiate an exposure of t milliseconds 
duration. 


<t> is an integer between 0 and 4 x 109 
The CCD must be in frame transfer mode (frame command). 


The shutter must previously have been opened with oshut and 
the CCD array cleared with cisc. 


fobs stops CCD clearing, integrates a frame on the image array 
for t milliseconds, transfers that frame from the image array to 
the storage array, reads out the storage array into the current 
image cache, and returns the CCD to continuous clearing. 


Reference: See frame. 
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<n> <t> focus 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


format 
Purpose: 


Parameters: 


Focus the camera. 


<n> is the number of exposures read out into the RS170 video 
display. 
<t> is the duration of each exposure in deciseconds. 


A current image must previously have been specified. 


This command takes a series of 100 x 100 pixel exposures of a 
specified duration, then reads out these exposures centered at 
the current cross cursor position while the user manually adjusts 
the camera for focus and alignment. 


The default cross cursor position is the center of the RS170 
video display. 


<n> <t> focus clears all image cache specifications and 
restores the system to startup conditions. 


By using the interactive cursor positioning routine (entered by 
sw), the user may specify the portion of the image plane to be 
focused. The sequence to follow is: 2 obs qshow sw 
(followed by movement of the cross cursor) <n> <t> focus. 
See sw. 


Pressing the ESC key terminates <n> <t> focus prematurely; 


default must then be executed to reset the readout format to 
the full CCD array. 


List the current image cache format set by cedfmt. 


None 


Computer Response: <m> <n> <c> <r> <p> <q>, where 


Prerequisites: 


<m> is the column offset, 

<n> is the row offset, 

<c> is the number of columns, 
<r> is the number of rows, 
<p> is the column binning, 
<q> is the row binning. 


None 
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fprint <filename> 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


frame 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


Print the specified file on the line printer. 


<filename> is the file to be printed. 


‘None 


fprint cannot print binary files and aborts if the specified file is 
not found in the current directory search path. 


Switch the CCD over to a frame transfer mode of operation. 
None 
None 


frame reduces the column length of the CCD by 50%; ccd 
restores the CCD to full frame operation. 


See ccd. 
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<C> <r> fset 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Specify the number of columns and rows in the current image 
cache. 


<c> is the number of columns in the current image cache. 
<r> is the number of rows in the current image cache. 


The current image cache must be defined before it can be 
specified. An image cache is defined when it is one integer 
larger than the last image cache provided with column and row 
size specifications. 


Because <c> <r> fset creates the image header but does not 
change the contents of an image cache, a defined but empty 
image cache may contain meaningless data. 

<C> <r> fset does not affect the size specifications of the CCD. 


<c> <r> fset may be used to recover the data portion of 
images after a clept command or manual reset. 


fwhere <filename> 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Display the offset and length of the specified archive file. 
<filename> is the name of the specified file. 
None 


fwhere issues an abort if the specified file does not exist in the 
current search path. 
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goff 


Purpose: 


Parameters: 
Prerequisites: 


Notes: 


References: 


gon 
Purpose: 
Parameters: 
Prerequisites: 


References: 


Turn off the graphics plane in the RS170 video monitor. 


None 
None 
The previous screen is retained in video RAM. 


Subsequent graphics activity or the gon command displays the 
previous screen, as well as any new information. 


See gon, gz. 


Turn on the graphics plane’in the RS170 video monitor. 
None 
None 


See goff, gz. 
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gz 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


hist 


Purpose: 


Parameters: 


Prerequisites: 


<n> i* 


Purpose: 


Parameters: 


Prerequisites: 


Erase the graphics plane in the RS170 video monitor. 
None | 
None 

The previous screen is not retained in video RAM. 


See goff, gon. 


Plot a histogram of the pixel distribution within the bounds of the 
graphics box cursor. 


None 


A current image must previously have been specified. 


Multiply the current image by the image in the specified image 
cache and leave the results in the current image cache. 


<n> is the number of the specified image cache. 
The two images must have the same size specifications. 


A current image must previously have been specified. 


83 


s cuihedantaaneminaameemeiaaniemmnataeiameendeetl 


<k> <n> 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


<n> i+ 


Purpose: 


Parameters: 


Prerequisites: 


<n> I- 


Purpose: 


Parameters: 


Prerequisites: 


I*/ 

Multiply the current image by a constant, then divide that 
product by the image in the specified image cache and leave 
the results in the current image cache. 


<k> is a constant between -32768 and +32767 
<n> is the number of the specified image cache 


The two images must previously have been specified. 
The two images must have the same size specifications. 


The divisor must not be zero; i*/ substitutes +32767 for a zero 
divisor. 


i*/ allows for calibration of an image with a flat field if k is 


approximately the value of the mean of the image in image 
cache n. 


Add the image in the specified image cache to the current 
image and leave the results in the current image cache. 


<n> is the number of the specified image cache. 
The two images must previously have been specified. 


The two images must have the same size specifications. 


Subtract the image in the specified image cache from the 
current image and leave the results in the current image cache. 


<n> is the number of the specified image cache. 
The two images must previously have been specified. 


The two images must have the same size specifications. 
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<n> i/ 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 
Reference: 
ioff 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


Divide the current image by the image in the specified image 
cache and leave the results in the current image cache. 


<n> is the number of the specified image cache. 
The two images must previously have been specified. 
The two images must have the same size specifications. 


The CCD program is exited if division by zero is attempted; the 
program can be resumed by typing ced. 


See i*/. 


Turn off the image plane in the RS170 video monitor. 
None 
None 


The previous screen is retained in video RAM and can be 
displayed with ion. 


The graphics terminal display remains unchanged. 


See ion, pz. 


85 


ion 
Purpose: 
Parameters: 
Prerequisites: 
Notes: 


Reference: 


~=- = 2 eee SVS ee ee ee ee en 


Turn on the image plane in the RS170 video monitor. 
None 

None 

The graphics terminal display remains unchanged. 


See ioff, pz. 


lf <filename> 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Ip 

Purpose: 
Parameters: 
Prerequisites: 


Reference: 


Commence loading the specified file. 
<filename> is the name of the specified file. 
None 


An abort is issued if the specified file cannot be found in the 
current search path. 


Redirect all terminal output to the line printer. 
None 
None 


See screen. 
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Is 


Purpose: List the images currently stored on the Winchester disk. 
Parameters: None 


Prerequisites: None 


maxmin 


Purpose: List the minimum and maximum pixel values for the entire 
current image, excluding a ten-pixel border at each edge. 


Parameters: None 
Computer Response: <min> <max>, where 


<min> is the minimum pixel value, 
<max> is the maximum pixel value. 


Prerequisites: None 
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a <m> <n> 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Reference: 


<m> <n> 
Purpose: 


Parameters: 
Prerequisites: 


Notes: 


Reference: 





mosaic 


Display two or more images end-to-end in the RS170 video 
display. 


<mp> is the first image in the composite. 
<n> is the number of images in the composite. 


A sequence of images must first be constructed with the seq 
command. 


Fewer than n images are displayed if the screen is filled before 
nis attained. 


If m is larger than the value previously given to the seq 
parameter, the command aborts with an error message. 


If the sum of the <m> <n> mosaic parameters is larger than 
the value previously given to the seq parameter, the program 
truncates the number of displayed images to the seq parameter 
value. 


See seq. 


movie 
Display a movie of images. 


<m> is the first image in the movie sequence. 
<n> is the number of images in the movie sequence. 


A sequence of images must first be constructed with the seq 
command. 


This command aborts with an error message if m is larger than 
the value previously given to the seq parameter. 


if the sum of the <m> <n> movie parameters is larger than the 
value previously given to the seq parameter, the program 
truncates the number of displayed images to the seq parameter 
value. 


See seq. 
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mtformat 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


newtape 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


nowait 


Purpose: 


Parameters: 


Notes: 


References: 


Format the 1/4-inch tape cartridge. 

None 

None 

mtformat must format the 1/4-inch tape cartridge before that 


tape cartridge can be used for the first time. Once a tape 
cartridge is formatted, it can be reused without reformatting. 


Initialize the 9-track or 1/4-inch cartridge tape. 

None 

The tape device must be closed. 

newtape erases all data, creates an empty tape catalog block, 
writes that block at the beginning of the tape, and records an 
end of information on the tape. Two end-of-files (EOFs) follow 
the 9-track tape catalog. 


Optional tape catalog preformatting is offered for the 1/4-inch 
tape. 


Cause a subsequent seq or video command to take exposures 
continuously. 


None 


This is the default configuration and remains in effect until either 
<t> secwait or trigwait is executed. 


See <t> secwait, trigwait. 
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nvideo 
Purpose: 
Parameters: 
Prerequisites: 


Reference: 


nxtimage 


Purpose: 


Parameters: 


Invert the output of the image plane in the RS170 video monitor. 
None 
The output must currently be in positive video. 


See pvideo. 


For any command that requires the user to provide the number 
of an image cache, replace that parameter with the number of 
the last defined but unspecified image cache. 


None 


Computer Response: <n> is the number of the last defined but unspecified 


Prerequisites: 


Notes: 


<t> obs 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


image cache. 
None 


nxtimage extract extracts a subimage into the next available 
unspecified image cache. 


Initiate an exposure of t deciseconds duration. 

<t> is an integer between 2 and 167,771 (4.7 hours). 

None 

<t> obs closes the shutter, clears the CCD array twice, opens 
the shutter for the specified time, and reads the CCD out into the 
current image cache. 


If the current image cache is specified to be a different size than 
the image to be read out, an error message is issued and the 
command is aborted. 
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oplot 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


oshut 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


page 
Purpose: 


Parameters: 


Prerequisites: 


pan 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Retain one plot while a second plot is drawn over it, using the 
axes scaling from the previous plot. 


None 
None 
oplot is valid for the next plot activity only; it is possible to 


overplot many times in succession by preceding each plot 
command by oplot. 


Open the shutter. 
None 
None 


cshut closes the shutter. 


Erase the graphics terminal screen. 
None 


None 


Center the image plane at the current cross cursor position. 
None 

A current image must previously have been specified. 

Any area of an oversized image can be displayed by moving the 


cross cursor to the edge of the image plane and entering pan, 
repeating this process as required. 
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<n> pcol 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


<m> <n> 


Purpose: 
Parameters: 


Prerequisites: 


Notes: 


pcur 


Purpose: 


Prerequisites: 


Plot the pixel values in the specified column as a graph of pixel 
intensity versus column pixel number. 


<n> is the number of the specified column 
A current image must previously have been specified. 


The specified column lies within the bounds of the current 
image. 


In a 320 x 512 image, column 320 does not exist, nor does row 
512. 


pcols 


Plot the average of the pixel values of columns m through n as a 
graph of pixel intensity versus column pixel number. 


<m> is the first column plotted 
<n> is the last column plotted 


A current image must previously have been specified. 


‘Columns m and n must both lie within the bounds of the current 
image. 


In a 320 x 512 image, column 320 does not exist, nor does row 
512. 


List the coordinates at the center of the graphics box cursor and 
the dimensions of that cursor. 


None 


~gcomputer Response: cursor is at col#_ row#_. box is __columns by _rows 


A current image must previously have been specified. 
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pid 
Purpose: Display the comment stored in the header of the current image. 
Parameters: None 


Prerequisites: A current image must previously have been specified. 


<C> <r> pixel 


Purpose: List the intensity value of the pixel located at the specified 
column and row of the current image. 


Parameters: <c> is the specified column 
<r> is the specified row 


Computer Response: <intensity> 


Prerequisites: A current image must previously have been specified. 


prdate 

Purpose: Display the date. 
Parameters: None 

Computer Response: <dd mon yy> 


Prerequisites: None 
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<n> prow 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


<m> <n> 


Purpose: 
Parameters: 


Prerequisites: 


Notes: 


prtime 
Purpose: 


Parameters: 


Plot the pixel values of a specified row as a graph of pixel 
intensity versus row number. 


<n> is the number of the specified row. 
A current image must previously have been specified. 


The specified row must lie within the bounds of the current 
image. 


In a 320 x 512 image, column 320 does not exist, nor does row 
512. 


prows 


Plot the average of the pixel values of rows m through n as a 
graph of pixel intensity versus row number. 


<m> is the first row in the range 
<n> is the last row in the range 


A current image must previously have been specified. 


Rows m and n must both lie within the bounds of the current 
image. 


In a 320 x 512 image, column 320 does not exist, nor does row 
512. 


Display the time. 


None 


Computer Response: <hr:min:sec> 


Prerequisites: 


None 
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pvideo 


Purpose: 


Parameters: 
Prerequisites: 
Notes: 


Reference: 


pz 

Purpose: 
Parameters: 
Prerequisites: 


References: 


qci 


Purpose: 


Parameters: 


Restore the output of the image plane in the RS170 video 
monitor to positive video. 


None 
None 
Positive video is the default state. 


See nvideo 


Erase the image plane from the RS170 video monitor. 
None 
None 


See ion, ioff. 


List the image cache number, number of columns, number of 
rows, and previously entered comment in the current image 
cache. 


None 


Computer Response: <n> <c> <r> <comment>, where 


Prerequisites: 


« 


<n> is the number of the current image cache 

<c> is the number of columns in the current image cache 

<r> is the number of rows in the current image cache 
<comment> is the comment previously entered into the image 
header by comment 


None 
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qimages 


Purpose: 


2a, ameters: 


List all defined image caches. (An image cache is defined 
when it is one integer larger than the last image cache provided 
with column and row size specifications.) 


None 


omputer Response: <n> <c> <r> <comment>, where 


Prerequisites: 


qshow 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


<n> is the image cache number 

<c> is the number of columns 

<r> is the number of rows 

<comment> is the comment previously entered into the image. _ 
header by comment €. me 
for each defined image cache. 


None 


Display the current image in the RS170 video monitor. 

None 

A current image must previously have been specified. 

qshow uses a 32 x 32 pixel area centered at the current 
position of the cross cursor as the source of data to determine 
the minimum and maximum pixel values for windowing. 

lf the minimum and maximum derived with qshow are not 


representative of the entire image, only the pixels within the 
reference area are scaled for optimal contrast. 
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<n> qsq 


Purpose: 


Parameters: 
Prerequisites: 


Notes: 


References: 


Display the image plane spatially compressed by a specified 
amount. 


<n> must be either 2 or 4. 

A current image must previously have been specified. 

qsq uses a 32 x 32 pixel box at the center of the current image 
as the source of data to determine the minimum and maximum 
pixel values for windowing. 

If the minimum and maximum derived with <n> qsq are not 
representative of the entire image, only the pixels within the 
reference area are scaled for optimal contrast. 


The current location of the cross cursor becomes the center of 
the image plane. 


qsq is not recursive. 


See <gmin> <gmax> <n> squeeze and <c> <r> zoom. 
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readout 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


recenter 
Purpose: 
Parameters: 
Prerequisites: 


Notes: 


Read out the CCD into the current image cache, using the 
current CCD format. 


None 

The current image cache must either be unspecified or the 
same size as the readout. An unspecified image cache is an 
image cache which has not been used since the last clept 
command or manual reset. 

CCD readout occurs as readout is executed. 


readout is used in conjunction with commands such as clrims, 
oshut, and cshut to build special exposure sequences. 


Center the current image in the RS170 video display. 

None 

None 

The <c> <r> zoom and <gmin> <gmax> <n> Squeeze 


factors are reset to 1 and the graphics cursors are restored to 
the center of the current image. 
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recover 
Purpose: 


Parameters: 


' Prerequisites: 


Notes: 


Reference: 


regular 


Purpose: 


Parameters: 


Prerequisites: 


References: 


reset 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


Recover the source codes from one or more floppy disks. 
None 
None 


The information on the floppy disks is that stored by the backup 
command. 


The user must insert each floppy disk in succession upon the 
program's request. The user must enter the floppy disks in the 
correct order, or the subsequent load will be incorrect. 


See backup. 


Return the image plane to its non-flipped, non-rotated 
orientation. 


None 
None 


See flip, rotated. 


Return the video display to default conditions. 
None 
None 


reset automatically executes the clept command to clear all 
existing image caches. 


See clcpt. 
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<n> riist 


Purpose: 


Parameters: 


Prerequisites: 


Reference: 


rmimage 


Purpose: 


Parameters: 
Prerequisites: 


Notes: 


Reference: 


rotated 


Purpose: 


Parameters: 
Prerequisites: 
Notes: 


References: 


List the pixel values in a specific row of the current image. 


<n> is an integer that is smaller than or equal to the number of 
rows in the current image. 


A current image must previously have been specified. 


See clist. 


If more than one image cache is defined, delete the image 
cache with the highest number. 


None 
None 


rmimage is voided if only one image cache is currently 
defined. 


See cliept. 


Transpose the image plane about a diagonal and set the image 
plane to its non-flipped orientation. 


None 
None 
regular returns the image plane to its non-rotated orientation. 


See flip, regular. 
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saveseq 


Purpose: 


Parameters: 
Prerequisites: 


References: 


sb 


Purpose: 
Parameters: 
Prerequisites: 


Notes: 


screen 
Purpose: 
Parameters: 
Prerequisites: 


Reference: 


Convert the current sequence of images acquired with the seq 
command into a single frame which is stored in image cache 1. 


None 
seq must first be executed. 


See seq. 


Enter the interactive box cursor positioning and sizing routine. 
None 
None 


The h, j, k, and | (H, J, K, and L) keys move the box cursor by 
unit (10-unit) increments. 





The position of the box cursor is displayed at the upper left side 
of the video display. The pixel value at that position is also 
displayed. 

The u, i, o, and p (U, I, O, and P) keys change the shape of the 
box cursor. The box cursor cannot be made smaller than a 2 x 2 
pixel array nor larger than the full CCD array. The box cursor 
cannot be moved outside of the range of the video display. 


This routine is exited with the q key. 


Redirect all output from the line prnter back to the terminal. 
None 
None 


See Ip. 
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<t> secwait 


Purpose: 


Parameters: 


Prequisites: 


Notes: 


Cause a subsequent seq or video command to wait a specified 
number of seconds between exposures. 


<t> is the number of seconds allowed to pass between 
exposures. 


None 


This command remains in effect until either nowait or trigwait 
is executed. 


References: See nowait, trigwait. 


<n> seq 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


Acquire a series of images with exposure and array parameters 
identical to those of a model image previously acquired into 
image cache 1. The mosaic and movie commands display 
these images. 


<n> is the number of images acquired. 

The user must clear all previously defined image caches with 
clept, acquire an image into image cache 1 by <t> obs, <t> 
fobs, or readout, specify a wait condition by nowait, <t> 
secwait, or trigwait, then execute seq with the number of 
images to be acquired. 


seq can fill the entire RAM buffer. If n images do not fit into 
RAM, the request is cancelled and an error message is issued. 


The wait condition specified is valid for each exposure in the 
sequence, including the first. 


See mosaic, movie. 
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setrec 


Purpose: Establish the position and size of the box cursor to be the format 
of the next camera readout. 
Parameters: None 
Prerequisites: None 
Notes: setrec is not recursive; the current image must be a full image 
for use of this command. 
<k> shade 
Purpose: Fill the current image cache with a shaded image. 
Parameters: <k>is aconstant. Normally, 1 or 2 is used. 
Prerequisites: None 4 
Notes: The shaded image is a uniform ramp which has a 0,0 (column, tr. 
row) pixel element of zero and which uniformly rises in rows and L 
columns until the pixel element has the value [k(number of . 
columns - 1) + (number of rows - 1)]. bia 
A k value of zero clears the current image cache. 
<k> shade is useful for testing the data transfer and video 
display capabilities of the system. 
<n> shift 
Purpose: Shift the parallel register of the CCD towards the serial register. 
Parameters: <n> is the number of rows shifted. 
Prerequisites: None 
Notes: <n> shift is most commonly used for time delay integration 


studies. 
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sho 
Purpose: 
Parameters: 


Prerequisites: 


Display the current image. 

None 

A current image must previously have been specified. 

Maximum and minimum pixel values for windowing must have 


been established by a prior <gmin> <gmax> show or 
qshow command, or altered during a prior sw routine. 


<gmin> <gmax> show 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


si>s 


Purpose: 


Parameters: 


Prerequisites: 


Display the current image with user-specified minimum and 
maximum pixel values for windowing. 


<gmin> is the minimum pixel value 
<gmax> is the maximum pixel value 


A current image must previously have been specified. 


<gmin> <gmax> show centers the current image within the 
RS170 video display. 


Transfer the frame integrated on the image array to the storage 
array. 


None 


The CCD must be in frame transfer mode (frame command). 
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slow 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


splot 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


sq 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


Change the readout rate to slow. 
None 
None 


Hardware and software readout rates must both be set to slow, 
or a nonsense image results. 


See fast. 


Output graphics commands on the RS170 video monitor. 
None 

None 

splot is the default configuration. 


See tplot. 


Display the current image centered in the image plane at the 
factor last selected by <gmin> <gmax> <n> squeeze. 


None 
A current image must previously have been specified. 


A prior <gmin> <gmax> <n> squeeze must have been 
executed. 


The cross cursor is automatically centered in the image plane. 


See <gmin> <gmax> <n> squeeze. 
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<gmin> <gmax> <n> squeeze 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


sreadout 


Purpose: 
Parameters: 


Prerequisites: 


Notes: 


Reference: 


Display the image plane compressed by a factor of 2 or 4. 
<gmin> is the minimum pixel value for windowing 

<gmax> is the maximum pixel value for windowing 

<n> is the amount by which the image plane is compressed 
(2 or 4 are valid parameters) 

A current image must previously have been specified. 


The current location of the cross cursor becomes the center of 
the image plane. 


This command is not recursive. 


See qsq, sq, and <c> <r> zoom. 


Read out the storage array of the CCD into the current image 
cache, using the current CCD format. 


None 
The CCD must be in frame transfer mode (frame command). 


The current image cache must either be unspecified or the 
same size as the readout. 


sreadout assumes the current image cache to be the correct 
size. If the image cache size is incorrect, the data may spill into 
the next available image cache. 

The readout occurs as sreadout is executed. 


See frame, si>s. 
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> stats 


Purpose: 


Parameters: 


Derive the pixel minimum, maximum, mean, and RMS of the 
area bounded by the box cursor. 


None 


Computer Response: <min> <max> <mean> <rms> 


Prerequisites: 


Notes: 


stop 


Purpose: 


Parameters: 


Prerequisites: 


A current image must previously have been specified. 
The box cursor is assigned to a 32 x 32 pixel area at the center 


of the image plane at each new assignment of a current image 
cache and at CCD readout. 


Stop ongoing camera activity (such as that begun by the cise 
command) and prepare the CCD for an exposure. 


None 


None 
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Ha sw 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


. tclose 


Purpose: 


Parameters: 


Prerequisites: 


Enter the interactive cross cursor positioning and windowing 
routine. 


None 
None 


The h, j, k, and | (H, J, K, and L) keys move the cursor by unit 
(10-unit) increments. 


The current location of the cross cursor, the pixel value at that 
location, and the current upper and lower window display 
parameters are displayed in a status line across the top of the 
video display. 

The u, i, 0, and p (U, I, O, and P) keys change the windowing of 
a 64 x 64 pixel subarray centered at the current cursor position. 
The new pixel values are shown at the upper right side of the 
video display. 


This routine is exited with the q key. 


Write the current directory back to tape with any modifications or 
additions from current use, then close and rewind the tape. 


None 


None 
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tinit 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


tip 


Purpose: 


Parameters: 


Prerequisites: 


tis 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


Initialize the 1/4-inch cartridge tape in order to make this tape 
available to the user. 


None 
None 
tinit must be entered each time that a new tape cartridge is 


inserted into the tape drive and before a tape cartridge is 
opened after power up. 


Wait for the CE200 or IC200 to finish before executing the next 
command. 


None 


None 


List all image cache headers that are on the current tape. 
None 

The tape must previously have been opened with topen. 

tls requires several minutes to read the headers on a full tape. 


See topen. 
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topen 
Purpose: 


Parameters: 


Prerequisites: 


voles: 


tplot 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


Open and initialize the tape. 
None 


newtape should be issued before topen if the tape is to be 
erased. 


For both 9-track and 1/4-inch cartridge tape, the tape data 
catalog is read from the beginning of the tape into the program 
catalog buffer. 


The 9-track tape program catalog buffer is updated to allow the 
program to maintain random access to any stored image; new 
data can only be written at the end of the tape. 

The 1/4-inch cartridge tape program catalog buffer permits date 
to be recorded over any existing file if the new data“aré Gal 
greater in extent than the original image. 


oe. 


Output graphics commands on the graphics terminal. 

None 

None 

lf the terminal is not a graphics device or if the graphics plot 
codes are not suitable for the terminal in use, the screen fills 
with meaningless characters. When this happens, the user may 
need to manually reset the computer. 


See splot. 
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<n> tr 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


trig 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


trigwait 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


References: 


Read an image from the current tape into the current image 
cache. 


<n> is the number of the file to be read into RAM. 
None 


if the current image cache is not the correct size, <n> tr 
terminates without changing the header. 


If the current image cache is defined but not specified, <n> tr 
specifies that image cache. 


Wait for an external trigger event. 


wai 


None 
None 


Command execution ceases until the external trigger signal 
pulses low (see Section 13.0, External Trigger Control). 


Cause a subsequent seq or video command to wait for an 
external trigger event between exposures. 


None 
None 


This command remains in effect until either nowait or <n> 
secwait is executed. 


See nowait and <n> secwait. 
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<n> tw 
Purpose: 


Parameters: 


Prerequisites: 


Notes: 


+twrite 
Purpose: 


Parameters: 


Prerequisites: 


unload 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Read the current image onto tape. 


<n> is the number of the tape file that is to receive the current 
image. 

None 

1/4-inch cartridge tape - when entered with a parameter, <n> 
tw instructs the tape to overwrite file n with a current image that 
is the same size or smaller. When entered without a parameter, 
<n> tw writes the current image onto the end of the tape. n 
may also specify recording at the end of the tape. 


9-track tape - n is ignored, because images can only be 
recorded at the end of information. 


Enable writing to the tape. 
None 


None 


Disengage the 1/4-inch tape cartridge from the tape drive or 
rewind the 9-track tape to the load point. 


None 
The 1/4-inch tape cartridge must first be closed. 


The 1/4-inch tape should not be removed from the tape drive 
before unload is issued and completed. 


If the 1/4-inch tape cartridge is not closed prior to issuance of 


the unload command, the CCD program prompts the user to 
close the cartridge with a message that the cartridge is open. 
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<t> <s> video 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


+write 
Purpose: 


Parameters: 


Prerequisites: 


Acquire a series of images, then display these images in rapid 
sequence. 


<t> is the duration of each exposure in milliseconds 
<s> is the delay between exposures in seconds 


The CCD must be in frame transfer mode (frame command). 


The command sequence for frame transfer acquisition and 
display is: 


osh cisc clcpt fbias 2 ci <t> <s> video 


In this sequence, osh opens the camera shutter, cise clears the 
image and storage arrays continuously, clept removes all 
image cache definitions, fbias reads a frame-mode bias into 
image cache 1, and 2 ci selects the second image cache to be 
the current image cache. video subtracts the bias frame from a 
newly acquired image, displays the bias-subtracted image, then 
delays for s seconds before acquiring a new image. This 
pattern of image acquisition, bias subtraction, and delay is 
repeated for each image acquired. 


video may be stopped by pressing any key. 


Enable writing to the Winchester disk. 
None 


None 
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-write 
Purpose: 
Parameters: 


Prerequisites: 


<m> <n> 


Purpose: 


Parameters: 


Prerequisites: 


Disable writing to the Winchester disk. 
None 


None 


xplot 


Extract data from between points m and n on the x axis of a 
graph previously displayed by pcol, pcols, prow, or prows. 
Plot these data to fill the screen. 


<m> is the first x axis endpoint plotted 
<n> is the second x axis endpoint plotted 


This command must be preceded by one of the following 
commands: pcol, pcols, prow, or prows. 


<m> <mm> <n> <nn> xyplot 


Purpose: 


Parameters: 


Prerequisites: 


Extract data from between points m and n on the x axis and 
points mm and nn on the y axis of a graph previously displayed 
by pcol, pcols, prow, or prows. Plot these data to fill the 
screen. 


<m> is the first x axis endpoint plotted 

<n> is the second x axis endpoint plotted 
<mm> is the first y axis endpoint plotted 
<nn> is the second y axis endpoint plotted 


This command must be preceded by one of the following 
commands: pcol, pcols, prow, or prows. 
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<m> <n> yplot 


Purpose: 


Parameters: 


Prerequisites: 


Extract data from between points m and n on the y axis of a 
graph previously displayed by pcol, pcols, prow, or prows. 
Plot these data to fill the screen. 


<m> is the first y axis endpoint plotted 
<n> is the second y axis endpoint plotted 


This command must be preceded by one of the following 
commands: pcol, pcols, prow, or prows. 


<C> <r> zoom 


Purpose: 


Parameters: 


Prerequisites: 


Notes: 


Reference: 


Display the current image centered at the cursor position as 
each pixel is written as many times as is required to satisfy the 
user-specified column and row parameters. 


<c> is the column parameter 
<r> is the row parameter 


A current image must previously have been specified. 


The input of different column and row values results in an 
asymmetrically displayed image. 


1 1 zoom leaves the image offset at the last cursor position 
prior to the first <c> <r> zoom command. 


See <gmin> <gmax> <n> squeeze. 
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3.0 FORTH CCD PROGRAM COMMANDS BY 


Camera Control 
<c> <r> binning 
<n> cgain 

cisc 

clrims 

creset 

cshut 

expose 

fast 

flash 

oshut 


readout 


slow 


sreadout 


tip 


Frame Transfer 


fbias 
<t> fobs 
frame 


nowait 


FUNCTION 


Set the column and row binning 

Set the gain parameter 

Continuously clear the CCD array 

Clear the CCD's image and storage arrays 
Reinitialize the camera controller 

Close the shutter 

Clear the CCD array and open the shutter 

Set the camera readout rate to fast 

Turn on the flashring for a specified length of time 
Open the shutter 


Read an image from the CCD's image and storage 
arrays into the current image cache 


Change the camera readout rate to slow 


Read an image from the CCD's storage array into 
the current image cache 


Wait for the CE200 or IC200 to finish before 
executing the next command. 


Read the electronic bias on the CCD 
Initiate an exposure in frame transfer mode 
Switch the CCD over to frame transfer mode 


Cause a subsequent seq or video command to 
take exposures continuously 
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ref 


<t> secwait 


si>s 


trigwait 


<t> <s> video 


+auto 

-auto 

goft 

gon 

gz 

hist 

oplot 

page 

<n> pcol 

<m> <n> pcols 
<n> prow 
<m> <n> prows 
sb 

splot 


sw 


Make the current image cache the reference cache 
for video 


Cause a subsequent seq or video command to 
wait t seconds between exposures 


Transfer the frame integrated on the image array to 
the storage array 


Cause a subsequent seq or video command to 
wait for an external trigger event between exposures 


Acquire and display a series of images in frame 
transfer mode 


Graphics Plane (Plotting Commands) 


Turn on the autoplot range feature 

Turn off the autoplot range feature 

Turn off the graphics plane 

Turn on the graphics plane 

Erase the. graphics plane 

Plot a histogram of graphics box intensity values 
Overplot the next plot activity 

Erase the terminal screen 

Plot a column section 

Plot a column range 

Plot a row section 

Plot a row range 

Turn on the graphics box cursor 

Direct graphics output to the RS170 video monitor 


Turn on the graphics cross cursor 
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tplot 


<m> <n>xplot 


Direct graphics output to the graphics terminal 


Extract and plot a portion of the x axis to fill the 
screen 


<m> <mm> <n> <nn> xyplot Extract and plot portions of the x and y 


<m> <n>yplot 


Image Arithmetic 
<k> c* 
<k> C+ 
<k> c- 
<k> c/ 
<n> i* 


<k> <n> i*/ 


<n> i+ 
<n> i- 


<n> i/ 


axes to fill the screen 


Extract and plot a portion of the y axis to fill the 
screen 


Multiply the current image by a constant 
Add a constant to the current image 
Subtract a constant from the current image 
Divide the current image by a constant 
Multiply the current image by another image 


Multiply the current image by a constant, then divide 
that product by another image 


Add another image to the current image 
Subtract another image from the current image 


Divide the current image by another image 


Image Caches (RAM) 


<n> ci 


clept 


clear 


<n> extract 


<C> <r> fset 


qci 


Select an image cache to be the current image 
cache 


Delete all image caches 


Clear the contents of the current image cache to 
zero 


Extract a subimage from a full image 
Specify the size of the current image cache 


List the specifications of the current image cache 
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qimages 
rmimage 


saveseq 


Image Capture 
bias 
<t> dark 
<t> obs 


trig 


Image Diagnostics 
<n> clist 
recover 
<n> rlist 


<k> shade 


Image Format 


List all currently defined image caches 
Delete the last image cache 


Convert images acquired with seq into a single 
frame which is stored in image cache 1 


Acquire a bias frame 
Acquire a dark source frame 
Acquire an image 


Wait for an external trigger event 


List the pixel values in a specified column 
Recover the source code from floppy disks 
List the pixel values in the specified row 


Fill the current image cache with a shaded image 


<m> <n> <C> <r> <p> <q> ccdfmt Set up explicitly the CCD area to’ 


default 


<n> extract 


<Mm> <n> <C> <I> <p> <q> !fmt 


format 


setrec 


be read out 


Reinitialize the computer's parameters to the full 
CCD array 


Extract a subimage from a full image 
Set formatting parameters 
List the format of the next camera readout 


Use the graphics box cursor to set the format of the 
next camera readout 
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Image Plane 


clist 

flip 

ioff 

ion 

<m> <n> mosaic 
<m> <n> movie 
nvideo 


pan 


pcur 
<m> <n> pixel 
pvideo 

pz 


qshow 


<n> qsq 


recenter 
regular 
reset 
rotated 


saveseq 


<n> seq 


List the pixel values in a specified column 
Reverse the orientation of the image plane 
Turn off the image plane 

Turn on the image plane 

Display a composite of images 

Display a movie of images 

Invert the image plane 


Display the current image centered at the cross 
cursor ; 


List the coordinates and size of the box cursor 

List the intensity value of the specified pixel 

Restore the image plane's output to positive video 
Erase the image plane 

Display the current image using a 32 x 32 pixel area 
at the cursor as the source of pixel values for 
windowing 

Compress the pixels in the image plane by a factor 
of 2 or 4 using a 32 x 32 pixel area at the cursor as 
the source of pixel values for windowing 

Center the current image in the video display 

Return the image plane to its original orientation 
Return all display parameters to default values 


Rotate the image plane 90° 


Convert images acquired with seq into a single 
frame 


Acquire copies of the current image 
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hs 


sho Display the current image with previously 
established pixel values for windowing 


<gmin> <gmax> showDisplay the current image with user-specified 
pixel values for windowing 


sq Display the current image at the last squeeze factor 


<gmin> <gmax> <n> squeeze Compress the pixels in the image plane 
and display the current image 


<c> <r> zoom Write pixels more than once and display the current 
image 


Image Setup 


ccd Select the CCD imaging device 
creset Reinitialize the camera controller 
<n> <t> focus Focus the camera 


Image Statistics 


hist Plot a histogram of intensity values of the area within 
the graphics box 


maxmin List the minimum and maximum pixel values for the 
entire current image 


stats Provide statistics of the box cursor 


Image Storage and File System Commands 


comment Enter a comment into the header of the current 
image 
ddatainit _ Initialize the data directory on the Winchester disk 


dir <directory name> Name adirectory to be the current directory 


<n> dr Read from an archive into the current image cache 
(RAM) 

<n> dw Write to an archive from the current image cache 
(RAM) 
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e 


file <filename> 
flist 

<n> fload 

fls 

fis-l 

fwhere <filename> 
If <filename> 


Is 


<n> newtape 


pid 


prdate 
prtime 
tclose 
tls 
topen 
<n> tr 
<n> tw 
+twrite 
unload 
+write 


-write 


Search for a specified file 

Display the contents of the open file table 

Load the current file 

Display the names of the files in the current directory 
Display the files in the current directory 

Display the offset and length of a file 

Commence loading a disk at the specified file 


List the files that are currently stored on the 
Winchester disk 


Initialize the tape 


Display the comment stored in the header of the 
current image 


Display the date entered by the user 
Display the current time 

Close and rewind the tape 

List the image headers on the current tape 
Open and initialize the tape 

Read from the tape 

Write to the tape 

Enable writing to the tape 

Remove the tape 

Enable writing to the Winchester disk 


Disable writing to the Winchester disk 
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Printer Control 


Ip 


screen 


Direct output to the line printer 


Direct output to the terminal screen 
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INDEX 


Notes: Index entries presented in bold type are commands. 
Italicized page numbers refer to text figures. 


1/4-inch magnetic tape, 35-36 

24 load, 53 

25 load, 1, 52, 54 

30 load, 54 

9-track magnetic tape, 35-36 
image header structure, 43, 45 
record set format, 43, 44 

\ prompt, 3, 60 

$tdate, 55 

$tdate ?, 55 

Aborts, 54, 60 

Archives, 35-36 

Arithmetic, 40 

+auto, 61,117 

-auto, 61, 117 

autoplot range feature, 61 

backup, 52, 62 

bf, 52 

bias, 17, 18, 62, 119 

Bias frame, 17 


Binary image, 54 


‘binning, 22, 63, 116 
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Binning concept, 22, 23, 24 


Bootstrap, 52 
bf, 52 
bw, 52 


Box cursor, 27 

bw, 1,52 

<k> c*, 40, 63, 118 
<k> c+, 40, 64, 118 
<k>c-, 40, 64, 118 
<k> c/, 40, 64, 118 
camera directory, 48 
<n> ccd, 65, 121 


CCD, 10-16, 17 
architectures, 14, 75 
charge transfer concept, 10, 72 
frame transfer CCD, 14 
full frame CCD, 14 
image array, 14 
pixel, 10 
pixel location, 18, 79 
readout, 10, 73 
storage array, 14 
subarrays, 17 
thinned CCD, 14, 16 


CCD program, 46-51 
file system, 47-48 
FORTH editor, 49-51 
lo FORTH editor, 51 
program files, 48-49 
tutorial, 1-9 
prompt (\), 60 


am 


we oe owt 


we 


<m> <n> <C> <I> <p> <q> 
ccdfmt, 17, 65, 119 


<n> cgain, 66, 116 
Channel stops, 10 
Charge-coupled device, See CCD 
Charge transfer concept, 10, 72 
<n> ci, 18, 20, 66, 118 
cisc, 67, 116 

clcept, 20, 67,118 

clear, 68, 118 

<n> clist, 68, 119, 120 
clrims, 69, 116 

Column length, 18, 79 
Command conventions, 60 
comment, 69, 121 
Control z (Az), 60 

creset, 70, 116, 121 
Cross cursor, 27 

cshut, 70, 116 

Current image cache, 46 
<t> dark, 17, 18, 70, 119 
Dark frame, 17 

ddata directory, 35 
ddatainit, 71, 121 
default, 71,119 
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<t> delay, 72 


dir <directory name>, 47, 72, 
121 


dir?, 47 
Display commands, 26, 29, 31, 32- 
34 


<n> dr, 18, 35, 72, 121 

<n> dw, 35, 36, 73, 121 
endate<mmddyy>, 54 
entime <hh:mm:ss>, 54 
expose, 73, 116 

External trigger, 57-58 

<n> extract, 18, 73, 118, 119 
fancy mode, 3, 28 

fast, 74,116 

fbias, 18, 74, 116 

<n> fcreate <filename>, 47 
fdelete <filename>, 47 
fempty?, 47 

ffmt, 52 

file <filename>, 47, 75, 122 
<t> flash, 75, 116 

flip, 31, 34,75, 120 

flist, 76, 122 

<t> fload, 76, 122 
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fls, 77, 122 
fls-l, 77, 122 


<m> <n> <C> <I> <p> <q> !fmt, 
78, 119 


<t> fobs, 18, 78, 116 

<n> <t> focus, 79, 121 
format, 79, 119 

FORTH boot kernel, 1, 2,3 
FORTH editor, 49-50 

fprint <filename>, 80 
frame, 80, 116 

<C> <r> fset, 18, 22, 81, 118 
Full frame, 17 

Full image, 17 


fwhere <filename>, 81, 122 


- Gates, 10 


gmin, 25 

gmax, 25 

goff, 25, 37, 82, 117 
gon, 25, 37, 82, 117 
Graphics cursors, 27 
Graphics plane, 25 
gz, 25, 37, 83, 117 


- Header, 22 


Header block definitions, 59 
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hist, 83, 117, 121 

<n> i*, 40, 83, 118 

<k> <n> i*/, 40, 84, 118 

<n> i+, 40, 84, 118 

<n> i-, 40, 84,118 

<n> i/, 40, 85, 118 

Image arithmetic, 40 

Image array, 14 

Image caches, 18-21, 46 
creation of, 20, 27 
definition of, 18, 20 
specification of, 18, 20 

Image display, 25-34 

Image header, 22 

Image plane, 25 

Image sequences, 41 

Interactive box cursor, 28 

Interactive cursor mode, 25, 27-28 

Interactive window cursor, 27-28 

ioff, 25, 85, 120 

loFORTH editor, 51 

ion, 25, 85, 120 

If <filename>, 47, 48, 86, 122 

Looping constructs, 56 

Ip, 86, 123 

Is, 87, 122 
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max, 25 

maxmin, 25, 87, 121 

min, 25 

<m> <n> mosaic, 41, 88, 120 
Mouse, 3, 28-29, 30 

<m> <n> movie, 41, 88, 120 
<n> ms, 55 

mtformat, 36, 89 

newdate, 55 

newtape, 36, 89, 122 
nowait, 41, 89, 116 

nvideo, 31, 90, 120 
nxtimage, 90 

<t> obs, 17, 18, 90, 119 
oplot, 37, 91, 117 

Origin, image, 18, 19 

oshut, 91, 116 

page, 37, 91,117 

pan, 31, 34,91, 120 

Parallel register, 10 
Parameters, 60, 61 

<n> pcol, 37, 38, 39, 92, 117 
<m> <n> pcols, 37, 92, 117 
peur, 28, 92, 120 

pid, 93, 122 
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<C> <r> pixel, 93, 120 
Pixel, 10 

Pixel location, 18, 19 
Pixel value, 25 

plain, 3 

Plotting commands, 37 
Potential wells, 10 
prdate, 55, 93, 122 
<n> prow, 37, 94, 117 
<m> <n> prows, 37, 94, 117 
prtime, 55, 94, 122 
pvideo, 31, 95, 120 
pz, 95, 120 

qci, 95,118 
qimages, 20, 96, 119 
qshow, 31, 96, 120 
<n> qsq, 31, 97, 120 
RAM, 18-22, 46 
readout, 18, 98, 116 
Readout, 10 
recenter, 31, 98, 120 
recover, 52, 99, 119 
ref, 117 


regular, 99, 120 
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reset, 22, 99, 120 

<n> rlist, 100, 119 
rmimage, 100, 119 
rotated, 100, 120 

Row length, 18, 79 
savebin, 54 

saveseq, 42, 101, 119, 120 
sb, 25, 28, 101,117 
screen, 101, 123 

<t> secwait, 41, 102, 117 
<n> seq, 41, 102, 120 


Serial register, 10 


“setclock, 54 


setrec, 18, 28, 103, 119 
<k> shade, 103, 119 
<n> shift, 103 

sho, 31, 104, 121 


<gmin> <gmax> show, 25, 29, 
104, 121 


si>s, 104, 117 
slow, 105, 116 
splot, 37, 105, 117 
sq, 31, 105, 121 


<gmin> <gmax> <n> squeeze, 
31, 33, 106, 121 


sreadout, 18, 106, 116 
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Standalone FORTH boot kernel, 1, 
2,3 


stats, 107, 121 

Status line, 3, 27 

stop, 107 

Storage array, 14 

Subarrays, 17 

Subimages, 17 

Super pixel, 22 

Super row, 22 

sw, 25, 27-28, 108, 117 

Tape drive, 35-36 
retrieving files from, 36 
writing files to, 36 

tclose, 36, 108, 122 

Terminal interrupt key, 60 


Terminals, supported, 3 
erasing the screen of, 37 


Thinned CCDs, 14, 16 
Time, 54-55 

time, 55 

time ?, 55 

tinit, 109 

tip, 109, 116 

tls, 109, 122 

topen, 36, 110, 122 
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tplot, 37, 110, 118 

en> tr, 18, 36, 111, 122 

trig, 111,119 

trigwait, 41, 111, 117 

e<n> tw, 36, 112, 122 

+twrite, 112, 122 

UNIX™ boot kernel, 1, 2 

unload, 36, 112, 122 

<t> <s> video, 113, 117 

Winchester disk, 35 
rebuilding, 53 
retrieving files from, 35 
writing files to, 35 

Window display parameters, 25 

Windowing, 25, 26 

+write, 35, 36, 113, 122 

-write, 35, 114, 122 

<m> <n> xplot, 37, 114, 118 


<m> <mm> <n> <nn> xyplot, 
37, 39, 114, 118 


<m> <n> yplot, 37, 38, 115, 118 


<C> <r> zoom, 31, 32, 115, 121 
unit zoom, 31 
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